Instance Property


A list of identifiers for items to show in the Touch Bar’s customization UI.


var customizationAllowedItemIdentifiers: [NSTouchBarItem.Identifier] { get set }


The customization UI shows these items in additional to the items in defaultItemIdentifiers.

The items you include in customizationAllowedItemIdentifiers appear individually in the customization UI, arranged in the same order as you specify in the array. As long as there’s available geometric space, a user can drag in to the associated bar any of the items in this list.

Always configure this property for a customizable bar.

The system archives this property.

See Also

Configuring User Customization

var customizationIdentifier: NSTouchBar.CustomizationIdentifier?

A globally unique string that makes the Touch Bar eligible for user customization.

var customizationRequiredItemIdentifiers: [NSTouchBarItem.Identifier]

An optional list of identifiers for items you want to always appear in the Touch Bar and which the user can’t remove during customization.

typealias NSTouchBar.CustomizationIdentifier

The default type for a Touch Bar customization identifier.

class var isAutomaticCustomizeTouchBarMenuItemEnabled: Bool

A Boolean value indicating whether the main menu contains an item for customizing the contents of the Touch Bar.