Skip to main content

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 header component
  • 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 brands pattern

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​

SlotRequiredDescription
contentYesInner markup for the masthead. Typically a container and grid row wrapping logo, navbar, tagline, or other components.

Props​

PropTypeDefaultDescription
labelstringOrganization identityAccessible name for the landmark.
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.subtleEmphasis-Lower emphasis; a muted, quieter weight.
.neutralEmphasisYesDefault emphasis; the standard weight at balanced contrast.
.accentEmphasis-Higher emphasis; a stronger, louder weight.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-Large.
.fluidLayout-Full-width, no max-width.
.containedLayoutYesConstrained to a max-width.
.stickyPosition-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.
  • header - primary site header, typically placed directly below the masthead
  • logo - logo component embedded inside the masthead
  • skip - skip link, placed alongside or above the masthead