Breadcrumbs

Render and style a breadcrumb trail from a supported SEO or breadcrumb integration. The trail reflects the current page context rather than a manually entered list of links.

Setup and First Use


Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.

  1. Activate and configure the supported breadcrumb or SEO plugin used by the site. Enable its breadcrumb output where the integration requires it.
  2. Add Breadcrumbs - Ultimate to a single or archive template.
  3. Choose the matching Seo plugin rather than an integration that is not installed.
  4. Set the wrapper tag, typography, link states, current-item styling, and supported separator options.
  5. Use provider-specific options only when they are available in the editor.
  6. Test a standard page, a nested page, a post, an archive, and WooCommerce contexts used by the site.

Controls and Settings


ControlPurpose and usage
Seo pluginOptions include All in One SEO, NavXT, Rank Math, SEOPress Pro, Slim SEO, Yoast, and Zynith. The selected integration must be available.
HTML tag / TypographyControls the surrounding markup and visual presentation, not the site hierarchy.
Links / Current itemSet link, hover, and current-item colors and current-item weight.
SeparatorCustomize the available separator symbol or icon, size, and color for supported providers. Not every integration exposes identical controls.
NavXT optionsDisable links, Reverse order, and Bypass internal caching apply specifically to NavXT.
Labels and taxonomyHome, search, 404, current-page visibility, and taxonomy controls are provider-dependent. Use only the options exposed for your chosen source.

Hierarchy and SEO Ownership


The selected integration determines the breadcrumb hierarchy and may provide its own settings for primary terms, archives, and structured data. Styling a BU breadcrumb does not automatically establish a new canonical hierarchy or guarantee a rich result in search engines. Avoid duplicate trails from theme hooks and the custom template.

Long Trails


Allow wrapping for long titles and keep separators readable. Test at mobile widths and in translated content. A template preview can differ from a real taxonomy, search, or error page, so validate the actual destinations.

Practical Example


Place a breadcrumb trail above a product title using the site's active SEO integration. Keep the current product label distinct from links and verify category hierarchy on the frontend.

Troubleshooting


  • Empty output: confirm the selected plugin is active and its breadcrumb feature is enabled.
  • Wrong parent category: review the SEO plugin's hierarchy or primary-term settings.
  • Duplicate output: remove an extra template instance or native breadcrumb hook rather than disabling the SEO plugin.

Related Documentation