---
title: "Toolbar Item Visibility Priority | Explore SwiftUI"
description: "Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples."
canonical_url: "https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority"
meta:
  author: "Explore SwiftUI"
  "og:description": "Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples."
  "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Toolbar%2BItem%2BVisibility%2BPriority%2Cdescription_Explore%2Bvisually%2Bwith%2Bcode%2Bexamples%2Ccategory_Toolbars%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3Rvb2xiYXJzL3Rvb2xiYXItaXRlbS12aXNpYmlsaXR5LXByaW9yaXR5Ig%2Cs_frdQtXtTbojs4VuS.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Toolbar Item Visibility Priority | Explore SwiftUI"
  "twitter:description": "Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples."
  "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Toolbar%2BItem%2BVisibility%2BPriority%2Cdescription_Explore%2Bvisually%2Bwith%2Bcode%2Bexamples%2Ccategory_Toolbars%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L3Rvb2xiYXJzL3Rvb2xiYXItaXRlbS12aXNpYmlsaXR5LXByaW9yaXR5Ig%2Cs_frdQtXtTbojs4VuS.png"
  "twitter:title": "Toolbar Item Visibility Priority | Explore SwiftUI"
---

> Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt)

**Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=238)

# **Toolbar Item Visibility Priority**

Defines the visibility priority for a toolbar item.

![Toolbar Item Visibility Priority - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/238/variants/733?v=1790073478842&r=2&w=800&q=80&f=webp)

### **Platform Compatibility**

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

### **Tags**

### **SwiftUI Code**

[ Docs](<https://developer.apple.com/documentation/swiftui/toolbarcontent/visibilitypriority(_:)>)

```
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](https://exploreswiftui.com/_ipx/f_webp&q_80&s_48x48/images/connect-wizard-icon.png)

**Connect Wizard**

**Unlock insights App Store Connect doesn’t show you.**

[** Get Started **](https://apps.apple.com/app/apple-store/id6747314580?pt=121213751&ct=Explore%20SwiftUI%20Banner&mt=8)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#webpage","@type":"WebPage","dateModified":"2026-08-30T12:17:00.179Z","datePublished":"2026-08-30T12:16:48.195Z","description":"Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples.","name":"Toolbar Item Visibility Priority","url":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority","breadcrumb":{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#article","dateModified":"2026-08-30T12:17:00.179Z","datePublished":"2026-08-30T12:16:48.195Z","description":"Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples.","headline":"Toolbar Item Visibility Priority","inLanguage":"en-US","name":"Toolbar Item Visibility Priority","thumbnailUrl":"https://exploreswiftui.com/api/images/238/variants/733?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@type":"WebSite","name":"Explore SwiftUI","url":"https://exploreswiftui.com"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/toolbarcontent/visibilitypriority(_:)","codeSampleType":"full example","description":"Defines the visibility priority for a toolbar item. Learn how to use Toolbar Item Visibility Priority in SwiftUI with visual code examples.","name":"Toolbar Item Visibility Priority SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"NavigationStack {\n    Text(\"FooBar\")\n        .toolbar {\n            ToolbarItem {\n                Button(\"1\", action: action)\n            }\n            .visibilityPriority(.init(lowerThan: .low))\n\n            ToolbarItem {\n                Button(\"2\", action: action)\n            }\n            .visibilityPriority(.low)\n\n            ToolbarItem {\n                Button(\"3\", action: action)\n            }\n            .visibilityPriority(.init(higherThan: .low))\n\n            ToolbarItem {\n                Button(\"4\", action: action)\n            }\n            .visibilityPriority(.automatic)\n\n            ToolbarItem {\n                Button(\"5\", action: action)\n            }\n            .visibilityPriority(.init(lowerThan: .high))\n\n            ToolbarItem {\n                Button(\"6\", action: action)\n            }\n            .visibilityPriority(.high)\n\n            ToolbarItem {\n                Button(\"7\", action: action)\n            }\n            .visibilityPriority(.init(higherThan: .high))\n\n            ToolbarItem {\n                Button(\"8\", action: action)\n            }\n            .visibilityPriority(.init(higherThan: .init(higherThan: .high)))\n        }\n    }","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"Toolbars"},{"@type":"Thing","name":"Toolbar Item Visibility Priority"}]},{"@id":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"Toolbars","item":"https://exploreswiftui.com/library/toolbars","position":2},{"@type":"ListItem","name":"Toolbar Item Visibility Priority","item":"https://exploreswiftui.com/library/toolbars/toolbar-item-visibility-priority","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/238/variants/733?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/238/variants/733?v=1790073478842&r=2"}]}
```