<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@T@NSToolbarItemVisibilityPriority"
  },
  "title" : "NSToolbarItem.VisibilityPriority"
}
-->

# NSToolbarItem.VisibilityPriority

Constants that indicate which toolbar items to keep in the toolbar when space is limited.

```
struct VisibilityPriority
```

## Overview

When a toolbar doesn’t have enough space to fit all its items, it pushes items into the overflow menu to make space. Use these constants to suggest a priority for individual toolbar items. The toolbar pushes low-priority items to the overflow menu first, followed by standard items and high-priority items. When two or more items share the same priority, the toolbar pushes the one closest to the trailing edge first.

## Topics

### Visibility priorities

[`static var standard: NSToolbarItem.VisibilityPriority`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/standard)

The default visibility priority.

[`static var low: NSToolbarItem.VisibilityPriority`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/low)

The lowest-priority for a toolbar item.

[`static var high: NSToolbarItem.VisibilityPriority`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/high)

A high priority that makes it less likely for the toolbar item to move to the overflow item.

[`static var user: NSToolbarItem.VisibilityPriority`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/user)

The highest priority for items in the toolbar.

### Initializers

[`init(Int)`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/init(_:))

Creates a visibility priority structure.

[`init(rawValue: Int)`](/documentation/AppKit/NSToolbarItem/VisibilityPriority-swift.struct/init(rawValue:))

Creates a visibility priority structure with the specified raw value.

## Relationships

### Conforms To

[`Sendable`](/documentation/Swift/Sendable)

[`BitwiseCopyable`](/documentation/Swift/BitwiseCopyable)

[`Escapable`](/documentation/Swift/Escapable)

[`Equatable`](/documentation/Swift/Equatable)

[`RawRepresentable`](/documentation/Swift/RawRepresentable)

[`Comparable`](/documentation/Swift/Comparable)

[`Copyable`](/documentation/Swift/Copyable)

[`Hashable`](/documentation/Swift/Hashable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

Copyright &copy; 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)