Skip to main content

Footer

Site footer shell with a full-width background. It declares no slots: every layout decision lives in the consumer's composition, so drop a container and grid into the footer and assemble link columns, brand, newsletter, social, and legal content there. Header is the companion shell and works the same way, so the two share one composition vocabulary.

Usage​

When to use

  • Every page in the site needs a consistent footer landmark
  • The footer must host multiple blocks (link columns, brand, newsletter, social, legal)
  • A full-width background is required behind footer content

When not to use

  • A single-line attribution strip - use a plain <footer> with minimal content
  • Embedded widgets that are not site-wide

Do

  • Use semantic headings inside link columns so screen reader users can jump between groups
  • Label nested <nav> elements with distinct aria-label values
  • Maintain sufficient contrast in all background and text states

Don't

  • Don't place the primary site navigation in the footer as the only navigation method
  • Don't let background images reduce text contrast below AA

API​

Props​

PropTypeDefaultDescription
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.
.fluidLayoutYesFull-width, no max-width.
.containedLayout-Constrained to a max-width.

Examples​

Default​

Classless <footer> composed into three rows of link columns, brand, newsletter, social, and legal content.

With background image​

Footer with a background image behind the composed content.

Mobile vertical​

Upper-row columns stack vertically on mobile; grid from md breakpoint.

Simple​

The smallest composition, a legal line and a back-to-top link on one row.

Accessibility​

  • WCAG 2.2 AA
  • <footer> provides the implicit contentinfo landmark
  • Navigation groups use <nav> with distinct aria-label values (e.g. "Footer navigation", "Legal")
  • Link columns use semantic headings so screen reader users can navigate between groups
  • Sufficient color contrast for background, text, and link states

Dependencies​

  • grid - inner layout of the composed rows
  • container - inner content alignment
  • header - companion shell at the top of the page
  • header - companion site shell composed the same way
  • linklist - common footer link column content