# Page Header

> Title a page with its breadcrumb, status and actions.

- Category: Navigation
- Import: `import { PageHeader } from "@sagui/ui";`
- Page: /components/page-header

```tsx
import { Badge, Breadcrumb, Button, PageHeader } from "@sagui/ui";

export function Hero() {
  return (
    <PageHeader
      className="w-full"
      breadcrumb={<Breadcrumb items={[{ label: "Vendors", href: "#" }, { label: "Acme Supply" }]} />}
      title="Acme Supply"
      status={<Badge tone="success">Active</Badge>}
      description="Vendor since March 2021"
      actions={<><Button variant="secondary">Edit</Button><Button>Create order</Button></>}
    />
  );
}
```

## When to use

- The top of every page inside AppShell.
- Detail pages that need a back link and a status Badge.

## When not to use

- Use a card title for sections within a page.

## Installation

Install the package and import the styles once. The [installation guide](/docs/installation) covers the Tailwind setup.

```bash
npm install @sagui/ui
```

## Usage

```tsx
import { PageHeader, Button } from "@sagui/ui";

<PageHeader title="Vendors" description="468 active" actions={<Button>Add vendor</Button>} />
```

## Examples

### Detail

```tsx
import { Badge, PageHeader } from "@sagui/ui";

export function Detail() {
  return (
    <PageHeader className="w-full" back={{ label: "Vendors", href: "#" }} title="Acme Supply" status={<Badge tone="warning">Pending review</Badge>} />
  );
}
```

## Accessibility

- The title is the page’s only `h1`.
- On phones the breadcrumb and search hide, and the actions wrap under the title.
