Toolbar Item Visibility Priority

Defines the visibility priority for a toolbar item.

Toolbar Item Visibility Priority - iOS Liquid Glass Light Mode Preview

Platform Compatibility

iOS 27.0+ iPadOS 27.0+ macOS 26.1+ watchOS 27.0+ tvOS 27.0+ visionOS 27.0+

Tags

SwiftUI Code

Docs
NavigationStack {
    Text("FooBar")
        .toolbar {
            ToolbarItem {
                Button("1", action: action)
            }
            .visibilityPriority(.init(lowerThan: .low))

            ToolbarItem {
                Button("2", action: action)
            }
            .visibilityPriority(.low)

            ToolbarItem {
                Button("3", action: action)
            }
            .visibilityPriority(.init(higherThan: .low))

            ToolbarItem {
                Button("4", action: action)
            }
            .visibilityPriority(.automatic)

            ToolbarItem {
                Button("5", action: action)
            }
            .visibilityPriority(.init(lowerThan: .high))

            ToolbarItem {
                Button("6", action: action)
            }
            .visibilityPriority(.high)

            ToolbarItem {
                Button("7", action: action)
            }
            .visibilityPriority(.init(higherThan: .high))

            ToolbarItem {
                Button("8", action: action)
            }
            .visibilityPriority(.init(higherThan: .init(higherThan: .high)))
        }
    }

Found an issue or have a suggestion?

Created: August 30, 2026Updated: August 30, 2026
Connect Wizard

Connect Wizard

Unlock insights App Store Connect doesn’t show you.

Get Started