PageHeader

PageHeader determines the top-level headings of a UI.

Page navigation navigation

Anatomy

PageHeader can include a context bar, title bar, description, and contextual navigation (pertaining to the current page).

By default, the context bar is visible on narrow viewports only, the title bar is visible on all viewports, and the leading action and trailing action are visible on regular viewports.

Edit in Figma

Context bar

The context bar is intended to set context for the user on smaller viewports and provide any actions that fit within the context bar. As a reminder, by default, the context bar (including its actions) is only visible on narrow viewports.

The default way to let users navigate up in the hierarchy on narrow viewports.

Edit in Figma

Context bar actions

Actions that appear in the context bar specifically.

Edit in Figma

Context bar area

The context bar is a generic slot for any component above the title region. Use it for custom breadcrumbs and other navigation elements instead of parent link.

Edit in Figma

Title bar

The title bar can include a static page title, actions, and leading and trailing visuals.

Default title variant

Most common page title size. Use for static titles in most situations.

Edit in Figma

Large title variant

Use large for for user-generated content such as issues, pull requests, or discussions.

Edit in Figma

Subtitle variant

Use subtitle when a title is already present in the page, such as in a Split page layout.

Edit in Figma

Leading visual

Leading visuals are optional and appear at the start of the title. They can be octicons, avatars, and other custom visuals that fit a small area. Leading visuals remain visible on all viewports.

Edit in Figma

Trailing visual

Trailing visual and trailing text can display auxiliary information. They're placed at the right of the item, and can denote status, privacy details, etc. Trailing visuals remain visible on all viewports.

Edit in Figma

Leading action

A back button can be used as a leading action for local navigation. On narrow viewports, use parent link instead.

Edit in Figma

Trailing action

Trailing action can display subtler actions aligned directly next to the title. On narrow viewports, replace the trailing action with an item in an overflow button.

Edit in Figma