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.
Avoid symbols that are:
- Complex or highly detailed.
- Visually very different from Firefox icons.
- Rectangular in shape.
- Made from letters, numbers, or characters.
Icon combinations
Recommended usage
- Mix of Firefox icons and SF symbols
- Firefox icons only
- SF symbols only
Icon combinations to avoid
- Using symbols without the symbol container
- 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 |