Interactive previews iPhone Duo

Prefer Vertical Toolbar Items

A compression behavior that prioritizes keeping toolbar items visible over other elements, such as tabs. By default, tabs are prioritized.

Prefer Vertical Toolbar Items - Preview Not Available

Platform Compatibility

iOS 27.1+ iPadOS 27.1+

Tags

SwiftUI Code

Docs
TabView {
    Tab("A", systemImage: "a.square") {
        NavigationStack {
            Text("FooBar")
                .toolbar {
                    ToolbarItem {
                        Button("1", systemImage: "1.circle", action: action)
                    }
                    ToolbarItem {
                        Button("2", systemImage: "2.circle", action: action)
                    }
                    ToolbarItem {
                        Button("3", systemImage: "3.circle", action: action)
                    }
                    ToolbarItem {
                        Button("4", systemImage: "4.circle", action: action)
                    }
                    ToolbarItem {
                        Button("5", systemImage: "5.circle", action: action)
                    }
                }
                .toolbarVerticalCompressionBehavior(.prefersToolbarItems)
            }
        }
    Tab("B", systemImage: "b.square") {}
    Tab("C", systemImage: "c.square") {}
    Tab("D", systemImage: "d.square") {}
    Tab("E", systemImage: "e.square") {}
    Tab("F", systemImage: "f.square") {}
}

Found an issue or have a suggestion?

Created: September 26, 2026Updated: September 26, 2026
Connect Wizard

Connect Wizard

Unlock insights App Store Connect doesn’t show you.

Get Started

More Toolbars Components

View all
Axis Behavior - iOS on iPhone Duo - Landscape - Closed - Liquid Glass - Light Mode - Preview
modifier

Axis Behavior

The bar axis behavior of the toolbar item.

Toolbar Item Visibility Priority - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Toolbar Item Visibility Priority

Defines the visibility priority for a toolbar item.

Toolbar Overflow Menu - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Toolbar Overflow Menu

The overflow menu of a toolbar. An overflow menu represents actions that are always placed in the toolbar’s overflow menu, regardless of the toolbar mode, platform, or customizability.

Pinned Toolbar Item Placement - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Pinned Toolbar Item Placement

A placement that pins the item to the trailing edge of the toolbar.

Remove Toolbar Item Margin - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Remove Toolbar Item Margin

Configures whether the content margins are removed.

Title Toolbar Item Placement - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializers

Title Toolbar Item Placement

Places content in the title area

ToolbarItem Shared Background Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

ToolbarItem Shared Background Visibility

Controls the visibility of the glass background effect on items in the toolbar. In certain contexts, such as the navigation bar on iOS and the window toolbar on macOS, toolbar items will be given a glass background effect that is shared with other items in the same logical grouping

ToolbarSpacer - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

ToolbarSpacer

A standard space item in toolbars

Explore Other Components

Browse all
CheckboxToggleStyle - macOS - Liquid Glass - Light Mode - Preview
style

CheckboxToggleStyle

A toggle style that displays a checkbox followed by its label.

Hidden List Section Separator - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Hidden List Section Separator

Sets whether to hide the separator associated with a list section.

Fitted Sheet Sizing - iPadOS - Landscape - Liquid Glass - Light Mode - Preview
modifier

Fitted Sheet Sizing

Sets the sizing of the containing presentation. This does not have any effect on smaller devices like iPhone and Apple Watch. On macOS, fitted is the default.

ButtonToggleStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
style

ButtonToggleStyle

A toggle style that displays as a button with its label as the title.

Custom List Section Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Custom List Section Spacing

Sets the spacing between adjacent sections in a List to a custom value.

CircularGaugeStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
style

CircularGaugeStyle

A gauge style that displays an open ring with a marker that appears at a point along the ring to indicate the gauge’s current value

DatePicker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

DatePicker

Creates an instance that selects a Date with an unbounded range

Vertical Divider - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
style

Vertical Divider

A vertical visual element that can be used to separate other content