breadcrumbs-usage
When to use
- Deep content pages — any page more than 2 levels deep in the site hierarchy.
- Content sections — product pages, documentation, blog posts with category structure.
- SEO benefit — breadcrumbs provide structured data for search engine results.
Key decisions
- Start level: Usually 1 to skip the root. Adjust for sites with shallow hierarchies.
- Current page: Show current page (non-linked) for context. Hide for cleaner look.
- Separator: breadcrumb-sep-chevron is most common. Match site design language.
- Enable/disable: Controlled via page-level enableBreadcrumb property, not by placing a block.
breadcrumbs-options
All authoring options
Behavior
classes_breadcrumbStartLevel: number (level to start, 0 = root)
classes_breadcrumbShowCurrent: boolean (show current page)
classes_breadcrumbHideOnRoot: boolean (hide on homepage)
Appearance
classes_breadcrumbSeparator: breadcrumb-sep-slash | breadcrumb-sep-arrow | breadcrumb-sep-chevron
classes_breadcrumbStyle: breadcrumb-style-default | breadcrumb-style-minimal
Analytics
trackClick: boolean
trackClick_meta: text