Masthead
Narrow identity bar at the top of the page carrying organization branding - logo/crest, organization name, and optional right-aligned utility links. Sits above the site header as the first visible element on the page. Common on government, university, and publisher sites. The background spans the full viewport width while the inner content aligns to .container.
Usage
When to use
- Government, university, or publisher sites that need a persistent identity strip above the header
- When the consumer wants a narrow branded bar separate from the main site header
- Any site where a parent organization identity (e.g. an agency or a parent institution) needs to sit above the site's own header
When not to use
- As the primary site header - use the
headercomponent - For the skip link - skip links are a separate component (skip) and sit alongside or above the masthead
- For a strip of partner logos - use the
brandspattern
Do
- Keep the masthead narrow and text-light; it should not compete with the site header
- Use the utilities area for cross-site links (change language, accessibility statement, parent organization)
- Ensure the masthead background has sufficient contrast with its text
Don't
- Put primary navigation inside the masthead
- Include calls to action - the masthead is an identity surface, not a marketing surface
- Nest a second masthead inside the first
API
Slots
| Slot | Required | Description |
|---|---|---|
content | Yes | Inner markup for the masthead. Typically a container and grid row wrapping logo, navbar, tagline, or other components. |
Props
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | Organization identity | Accessible name for the landmark. |
classes | array | - | Additional CSS class words merged into the root element. |
attributes | object | - | Additional HTML attributes spread on the root element. |
Classes
| Class | Capability | Default | Description |
|---|---|---|---|
.subtle | Emphasis | - | Lower emphasis; a muted, quieter weight. |
.neutral | Emphasis | Yes | Default emphasis; the standard weight at balanced contrast. |
.accent | Emphasis | - | Higher emphasis; a stronger, louder weight. |
.sm | Size | - | Small. |
.md | Size | Yes | Medium. |
.lg | Size | - | Large. |
.fluid | Layout | - | Full-width, no max-width. |
.contained | Layout | Yes | Constrained to a max-width. |
.sticky | Position | - | Pins the component to a viewport edge while scrolling. |
Examples
Default
Logo, organization name, and utility links on a narrow bar.
Sticky
Sticky masthead that persists on scroll.
Government
Brand on a narrow column beside cross-site and language navigation, the arrangement a government network uses to place one site among many.
University
Brand and tagline on one side, audience navigation on the other.
Publisher
Brand and publication date beside section and account navigation.
Accessibility
- WCAG 2.2 AA
- The masthead is wrapped in
<aside aria-label="Organization identity">so it exposes a real ARIA landmark that screen reader users can identify. - Utility links are standard
<a>elements with descriptive text. - The bar background and text meet contrast requirements.
- The masthead does not trap keyboard focus or reorder the tab sequence.