---
title: NSToolbarItem
framework: appkit
role: symbol
role_heading: Class
path: appkit/nstoolbaritem
---

# NSToolbarItem

A single item that appears in a window’s toolbar.

## Declaration

```swift
@MainActor class NSToolbarItem
```

## Overview

Overview An NSToolbarItem object displays an image and text string in the toolbar area of a window. You can also create toolbar items that display custom views you provide. Toolbar items provide fast access to common commands or features in the window. For example, the Finder window uses toolbar items to help someone navigate the file system. You typically create toolbar items at the same time you create your window’s toolbar. The system provides some standard items like spacers you can include in your toolbar. It also provides items that display standard interfaces like the color panel or font panel. For any custom toolbar items you create, provide an action method to call when someone clicks the item. You can display your toolbar item’s content using a custom view if you prefer, rather than an image and text label. If you specify an NSSearchField object for the view, the system automatically adjusts the minimum and maximum size of the search field to the system-standard values.

## Topics

### Creating a toolbar item

- [init(itemIdentifier:)](appkit/nstoolbaritem/init(itemidentifier:).md)
- [init(itemIdentifier:barButtonItem:)](appkit/nstoolbaritem/init(itemidentifier:barbuttonitem:).md)

### Getting the toolbar item’s identity

- [itemIdentifier](appkit/nstoolbaritem/itemidentifier.md)
- [NSToolbarItem.Identifier](appkit/nstoolbaritem/identifier.md)

### Describing the item

- [possibleLabels](appkit/nstoolbaritem/possiblelabels.md)
- [label](appkit/nstoolbaritem/label.md)
- [paletteLabel](appkit/nstoolbaritem/palettelabel.md)
- [title](appkit/nstoolbaritem/title.md)
- [toolTip](appkit/nstoolbaritem/tooltip.md)

### Getting the item’s visual appearance

- [image](appkit/nstoolbaritem/image.md)
- [backgroundTintColor](appkit/nstoolbaritem/backgroundtintcolor.md)
- [view](appkit/nstoolbaritem/view.md)

### Performing the item’s action

- [target](appkit/nstoolbaritem/target.md)
- [action](appkit/nstoolbaritem/action.md)

### Configuring the item’s menu

- [menuFormRepresentation](appkit/nstoolbaritem/menuformrepresentation.md)
- [itemMenuFormRepresentation](appkit/nstoolbaritem/itemmenuformrepresentation.md)

### Getting the item’s configuration

- [isVisible](appkit/nstoolbaritem/isvisible.md)
- [isHidden](appkit/nstoolbaritem/ishidden.md)
- [isBordered](appkit/nstoolbaritem/isbordered.md)
- [isNavigational](appkit/nstoolbaritem/isnavigational.md)
- [isEnabled](appkit/nstoolbaritem/isenabled.md)
- [badge](appkit/nstoolbaritem/badge-17r3r.md)
- [NSItemBadge](appkit/nsitembadge-swift.struct.md)
- [style](appkit/nstoolbaritem/style-swift.property.md)
- [NSToolbarItem.Style](appkit/nstoolbaritem/style-swift.enum.md)
- [visibilityPriority](appkit/nstoolbaritem/visibilitypriority-swift.property.md)
- [NSToolbarItem.VisibilityPriority](appkit/nstoolbaritem/visibilitypriority-swift.struct.md)
- [tag](appkit/nstoolbaritem/tag.md)

### Getting the parent toolbar

- [toolbar](appkit/nstoolbaritem/toolbar.md)

### Validating the item

- [autovalidates](appkit/nstoolbaritem/autovalidates.md)
- [validate()](appkit/nstoolbaritem/validate().md)

### Deprecated

- [allowsDuplicatesInToolbar](appkit/nstoolbaritem/allowsduplicatesintoolbar.md)
- [minSize](appkit/nstoolbaritem/minsize.md)
- [maxSize](appkit/nstoolbaritem/maxsize.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Inherited By

- [NSMenuToolbarItem](appkit/nsmenutoolbaritem.md)
- [NSSearchToolbarItem](appkit/nssearchtoolbaritem.md)
- [NSSharingServicePickerToolbarItem](appkit/nssharingservicepickertoolbaritem.md)
- [NSToolbarItemGroup](appkit/nstoolbaritemgroup.md)
- [NSTrackingSeparatorToolbarItem](appkit/nstrackingseparatortoolbaritem.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [Copyable](swift/copyable.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [NSCopying](foundation/nscopying.md)
- [NSMenuItemValidation](appkit/nsmenuitemvalidation.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSValidatedUserInterfaceItem](appkit/nsvalidateduserinterfaceitem.md)
- [Sendable](swift/sendable.md)
- [UIPopoverPresentationControllerSourceItem](uikit/uipopoverpresentationcontrollersourceitem.md)

## See Also

### Items

- [NSToolbarItemGroup](appkit/nstoolbaritemgroup.md)
- [NSToolbarItemGroup.ControlRepresentation](appkit/nstoolbaritemgroup/controlrepresentation-swift.enum.md)
- [NSToolbarItemGroup.SelectionMode](appkit/nstoolbaritemgroup/selectionmode-swift.enum.md)
- [NSMenuToolbarItem](appkit/nsmenutoolbaritem.md)
- [NSSearchToolbarItem](appkit/nssearchtoolbaritem.md)
- [NSTrackingSeparatorToolbarItem](appkit/nstrackingseparatortoolbaritem.md)