Home

Breadcrumbs

Usage

Breadcrumbs show the current page context within the site hierarchy. Start with:

  • --breadcrumbs-separator and --breadcrumbs-gap for layout rhythm

  • --breadcrumbs-link-color and --breadcrumbs-current-color for state styling

  • --breadcrumbs-font-size to align with site chrome typography

Tokens

TokenDescriptionDefault Value
--breadcrumbs-font-familyBreadcrumb font familyvar(--layout-font-family)
--breadcrumbs-font-sizeBreadcrumb font sizevar(--layout-font-size)
--breadcrumbs-separatorSeparator character"/"
--breadcrumbs-separator-colorSeparator colorvar(--text-color-muted)
--breadcrumbs-link-colorLink colorvar(--text-color-secondary)
--breadcrumbs-link-color-hoverLink hover colorvar(--text-color-primary)
--breadcrumbs-current-colorCurrent page colorvar(--text-color-primary)
--breadcrumbs-gapGap between itemsvar(--space-1)
--breadcrumbs-margin-bottomSpace below breadcrumbsvar(--space-4)

Examples

Arrow Separators

Use arrows for a stronger hierarchy cue:

:root {
  --breadcrumbs-separator: ">";
  --breadcrumbs-gap: var(--space-2);
}

Subtle Breadcrumbs

Keep breadcrumbs quiet while maintaining structure:

:root {
  --breadcrumbs-link-color: var(--text-color-muted);
  --breadcrumbs-current-color: var(--text-color-secondary);
}

Tips

Separator spacing: Use --breadcrumbs-gap to keep separators readable on narrow screens.

Hierarchy clarity: Increase contrast for --breadcrumbs-current-color to emphasize the current page.

© 2026 Stencila