> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ToolbarItemPlacement

> Specifies where a toolbar item is placed, using semantic roles or explicit positions.

```typescript theme={null}
type ToolbarItemPlacement =
    // Semantic placements
    | "automatic"
    | "principal"
    | "navigation"
    | "primaryAction"
    | "secondaryAction"
    | "status"
    | "confirmationAction"
    | "cancellationAction"
    | "destructiveAction"
    // Positional placements
    | "bottomBar"
    | "topBarLeading"
    | "topBarTrailing"
    | "navigationBarLeading"
    | "navigationBarTrailing"
    | "bottomOrnament"
    | "keyboard"
    | "largeSubtitle"
    | "subtitle"
    | "title";
```

<ParamField path="automatic" type="string">
  Automatically determines placement based on semantic role and platform conventions.
</ParamField>

<ParamField path="principal" type="string">
  The principal item, typically placed in the center of the toolbar.
</ParamField>

<ParamField path="navigation" type="string">
  Navigation-related items, usually in the leading area.
</ParamField>

<ParamField path="primaryAction" type="string">
  The primary action for the current context. Typically trailing edge.
</ParamField>

<ParamField path="secondaryAction" type="string">
  Secondary actions, placed in less prominent positions.
</ParamField>

<ParamField path="status" type="string">
  Status information displays.
</ParamField>

<ParamField path="confirmationAction" type="string">
  Confirmation actions like "Save" or "Done". Typically trailing edge.
</ParamField>

<ParamField path="cancellationAction" type="string">
  Cancellation actions like "Cancel". Typically leading edge.
</ParamField>

<ParamField path="destructiveAction" type="string">
  Destructive actions like "Delete". Placed to prevent accidental activation.
</ParamField>

<ParamField path="bottomBar" type="string">
  Places the item in the bottom bar.
</ParamField>

<ParamField path="topBarLeading" type="string">
  The leading side of the top bar.
</ParamField>

<ParamField path="topBarTrailing" type="string">
  The trailing side of the top bar.
</ParamField>

<ParamField path="navigationBarLeading" type="string">
  The leading side of the navigation bar.
</ParamField>

<ParamField path="navigationBarTrailing" type="string">
  The trailing side of the navigation bar.
</ParamField>

<ParamField path="bottomOrnament" type="string">
  A bottom ornament, typically for visionOS.
</ParamField>

<ParamField path="keyboard" type="string">
  An accessory bar above the on-screen keyboard.
</ParamField>

<ParamField path="largeSubtitle" type="string">
  A large subtitle in the navigation bar.
</ParamField>

<ParamField path="subtitle" type="string">
  A subtitle in the navigation bar.
</ParamField>

<ParamField path="title" type="string">
  The title area of the navigation bar.
</ParamField>
