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

# ToolbarMinimizationBehavior

The minimization behavior of a toolbar.

```
struct ToolbarMinimizationBehavior
```

## Overview

Use this type with the [`toolbarMinimizationBehavior(_:for:)`](/documentation/SwiftUI/View/toolbarMinimizationBehavior(_:for:))
modifier to control how toolbars minimize in response to scrolling.

On iOS, you can minimize the navigation bar using
[`onScrollDown`](/documentation/SwiftUI/ToolbarMinimizationBehavior/onScrollDown) or [`onScrollUp`](/documentation/SwiftUI/ToolbarMinimizationBehavior/onScrollUp):

```
NavigationStack {
    ScrollView {
        // ...
    }
    .toolbarMinimizationBehavior(
        .onScrollDown, for: .navigationBar)
}
```

## Topics

### Getting behaviors

[`static var automatic: ToolbarMinimizationBehavior`](/documentation/SwiftUI/ToolbarMinimizationBehavior/automatic)

The system determines the minimize behavior. By default,
navigation bars on iOS will minimize when the view has a
searchable using the [`toolbarPrincipal`](/documentation/SwiftUI/SearchFieldPlacement/toolbarPrincipal)
placement.

[`static let never: ToolbarMinimizationBehavior`](/documentation/SwiftUI/ToolbarMinimizationBehavior/never)

The toolbar cannot be minimized.

[`static let onScrollDown: ToolbarMinimizationBehavior`](/documentation/SwiftUI/ToolbarMinimizationBehavior/onScrollDown)

Minimize when scrolling down.

[`static let onScrollUp: ToolbarMinimizationBehavior`](/documentation/SwiftUI/ToolbarMinimizationBehavior/onScrollUp)

Minimize when scrolling up.

## Relationships

### Conforms To

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

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

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

[`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)