# Using contextual menu and toolbar item keys Learn about adding contextual menu items and toolbar items to a Safari app extension with information property list keys. ## Discussion Contextual menu items and toolbar items give you ways to add more menu options and entry points to your Safari app extension. You define and adjust these items using information property list keys. ### Add context menu items The `SFSafariContextMenu` key lets your app extension add items to the context menu that appears in webpages. See [Context menus](https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/) for design guidelines. ![A screenshot of a context menu in Safari. It’s a vertical menu containing five options, including Reload Page and Inspect Element. ](images/com.apple.safariservices/media-3027377@2x.png) The key’s value must be an array, and must contain one dictionary with two subkeys for each menu item. |Subkey |Type |Description | |---------|------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |`Text` |String|Required. A string that specifies the text to display for the context menu item. | |`Command`|String|Required. A string that the context menu item sends when it activates. It contains the name of the command you want to send to your app extension when the user selects your item.| For example, if you add two contextual menu items, your `Info.plist` file might look like the following: ```other SFSafariContextMenu Text Search for selected text in MyApplication. Command Search Text Add an entry for selected text in MyApplication. Command Add ``` ### Add a toolbar item The `SFSafariToolbarItem` dictionary adds a toolbar item to Safari windows. See [Toolbars](https://developer.apple.com/design/human-interface-guidelines/macos/windows-and-views/toolbars/) for design guidelines. ![A screenshot of a partial Safari toolbar. It shows standard toolbar items, as well as an app extension toolbar item that looks like a lightning bolt inside a circle. ](images/com.apple.safariservices/media-3027375@2x.png) Each app extension can have only one toolbar item. The value for this key is a dictionary that describes the toolbar item. There are four required keys for the toolbar item dictionary. |Subkey |Type |Description | |------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |`Identifier`|String|Required. A string identifier for the toolbar item. This doesn’t display to the user. | |`Label` |String|Required. A string that appears in the overflow menu, in the Customize palette, and on hover. | |`Image` |String|Required. A string specifying the filename of a scalable PDF image. The image must be transparent. Add the image file to your extension’s Xcode target. | |`Action` |String|Required. A string specifying the command to send when the user clicks the toolbar item. Available actions are `Command` (to send a command to the app extension) and `Popover` (to display a popover window). This action determines which methods you need to implement to handle button events.| Here’s an example dictionary in XML: ```other Action Command Identifier Button Image Toolbar.pdf Label My Item ``` Use the `Image` key to provide an image for the toolbar button. Safari may resize or recolor the toolbar button image when drawing it to the screen. Make your image a template image and follow the guidelines for toolbar items. > Note: > Buttons on the Safari toolbar are largely transparent, allowing them to fill with the appropriate gradient for the current macOS user interface. You don’t need to draw the button itself. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)