Menu

A temporary surface showing a short list of choices.

menu-image-ios

Usage

A temporary menu that surfaces actions relevant to a specific item, rather than the whole screen. Can appear from a variety of triggers — buttons, list items, cards, and other elements — typically activated by a tap or long-press.

Design properties

Property Values Default
Section title Boolean true | false true

Types

Default

By default, menu items include icons and horizontal dividers.

With header

Use an optional header to provide additional context.

Destructive action

Use for any Remove, Delete, or Close actions. Always place the destructive action at the bottom.

Behavior and interaction

Configuration

Menus can appear when users interact with an icon button or long-press.

Positioning

  • Position relative to the trigger element (button, long-press area)
  • Adjust positioning to stay within viewport boundaries
  • Optimal Positioning:
    • Below trigger when space allows
    • Above trigger when bottom space is limited
    • Offset to avoid covering the trigger element

Icon usage

Context menus on iOS can draw icons from two sources: our custom Firefox icons and Apple’s SF symbols. Both are allowed here because SF symbols bring system benefits like dynamic type scaling. Since our Firefox icon styling leans into a round look, SF symbols can blend in and sit alongside them.

This flexibility is scoped to context menus only. Our default Firefox icon styling remains the visual standard everywhere else in the product.

  • Use SF symbols only in context menus.
  • Always place a symbol using the symbol component property and ensure the text style is set to “Headline.” This ensures the symbol looks cohesive with the rest of the icons in the menu, whether it is a Firefox icon or SF symbol.
  • Firefox icons and SF symbols can be mixed in the same menu.
  • Don’t use SF symbols anywhere outside of context menus.
  • Don’t add a symbol without the symbol container.

Selecting symbols

Choose SF symbols that:

  • Look like Firefox icons – simple and outlined.
  • Fit a roughly square bounding box.
  • Are outlined (preferred); simple filled symbols are okay too.
ios-menu-icon-usage-good-symbols-examples

Avoid symbols that are:

  • Complex or highly detailed.
  • Visually very different from Firefox icons.
  • Rectangular in shape.
  • Made from letters, numbers, or characters.
ios-menu-icon-usage-bad-symbols-examples

Icon combinations

ios-menu-icon-usage-do
  1. Mix of Firefox icons and SF symbols
  2. Firefox icons only
  3. SF symbols only

Icon combinations to avoid

ios-menu-icon-usage-dont
  1. Using symbols without the symbol container
  2. Applying symbols without the “Headline” text style

Changelog

Date

Version

Notes

Sept 10, 2026

1.1.0

Updated guidelines

Sep 24, 2025

1.0.0

First release of Menu component documentation