<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 26.1.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -",
    "watchOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/ToolbarItemVisibilityPriority",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI29ToolbarItemVisibilityPriorityV"
  },
  "title" : "ToolbarItemVisibilityPriority"
}
-->

# ToolbarItemVisibilityPriority

A value that defines the visibility priority of a toolbar item.

```
struct ToolbarItemVisibilityPriority
```

## Overview

When a toolbar runs out of space, it moves items into an overflow
menu. Visibility priority controls the order in which that happens:
items with a lower priority move first, keeping higher-priority
items visible longer as the window shrinks.

Use values of this type with the
[`visibilityPriority(_:)`](/documentation/SwiftUI/ToolbarContent/visibilityPriority(_:)) modifier. For example,
to keep a share button visible longer than an archive button:

```
struct RootView: View {
    var body: some View {
        ContentView()
            .toolbar {
                ToolbarItem {
                    SecondaryControl()
                }
                ToolbarItem {
                    PrimaryControl()
                }
                .visibilityPriority(.high)
            }
    }
}
```

## Topics

### Getting system priorities

[`static let automatic: ToolbarItemVisibilityPriority`](/documentation/SwiftUI/ToolbarItemVisibilityPriority/automatic)

The default priority that lets the system determine the item’s
visibility in the toolbar.

[`static let low: ToolbarItemVisibilityPriority`](/documentation/SwiftUI/ToolbarItemVisibilityPriority/low)

A priority that moves the item to the overflow menu before
items with the default or high priority.

[`static let high: ToolbarItemVisibilityPriority`](/documentation/SwiftUI/ToolbarItemVisibilityPriority/high)

A priority that keeps the item in the toolbar longer than
items with the default or low priority.

### Creating custom priorities

[`init(lowerThan: ToolbarItemVisibilityPriority)`](/documentation/SwiftUI/ToolbarItemVisibilityPriority/init(lowerThan:))

Creates a priority lower than the specified value.

[`init(higherThan: ToolbarItemVisibilityPriority)`](/documentation/SwiftUI/ToolbarItemVisibilityPriority/init(higherThan:))

Creates a priority higher than the specified value.

## Relationships

### Conforms To

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

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

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

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

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

---

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)