<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 7.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/ToolbarItemPlacement/primaryAction",
  "metadataVersion" : "0.1.0",
  "role" : "Type Property",
  "symbol" : {
    "kind" : "Type Property",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI20ToolbarItemPlacementV13primaryActionACvpZ"
  },
  "title" : "primaryAction"
}
-->

# primaryAction

A placement for the primary action.

```
static let primaryAction: ToolbarItemPlacement
```

## Discussion

A primary action is a more frequently used action for the current
context. For example, a button the user clicks or taps to compose a new
message in a chat app.

In macOS and in Mac Catalyst apps, the location for the primary action
is the leading edge of the toolbar.

In iOS, iPadOS, and tvOS, the location for the primary action is
the trailing edge of the navigation bar.

In watchOS the system places the primary action beneath the
navigation bar; the user reveals the action by scrolling.

---

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)