Home » Components » Partials » Widgets »

Breadcrumb

November 29, 2025· 1 min · Gautham Chettiar

Displays breadcrumb navigation based on page ancestors. The first ancestor is always labeled “Home”.

Location : layouts/_partials/widgets/breadcrumb.html

Parameters :

Parameter	Type	Description	Default
`page`	Page	Page context	required
`site`	Site	Site context	required
`separator`	string	Separator between items	`" » "`
`class`	string	Additional CSS classes	-
`key`	string	Config key for visibility	`"Breadcrumb"`

Configuration :

yaml
params:
  showBreadcrumb: true       # Show/hide breadcrumb
  breadcrumbSeparator: " » " # Separator between items

Examples :

go
// Basic usage
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site) }}

// Custom separator
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site "separator" " / ") }}

// With custom class
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site "class" "top-nav") }}

go
// Basic usage
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site) }}

// Custom separator
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site "separator" " / ") }}

// With custom class
{{ partial "widgets/breadcrumb.html" (dict "page" . "site" .Site "class" "top-nav") }}