{"id":2403,"date":"2021-05-31T10:49:19","date_gmt":"2021-05-31T07:49:19","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=2403"},"modified":"2026-09-02T10:56:06","modified_gmt":"2026-09-02T07:56:06","slug":"breadcrumbs","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/general-options\/breadcrumbs\/","title":{"rendered":"Breadcrumbs"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Blocksy&#8217;s <strong>Breadcrumbs<\/strong> system helps visitors understand where they are within your website&#8217;s hierarchy and provides a convenient way to navigate back through parent sections. Breadcrumbs are supported across posts, pages, archives, WooCommerce content and properly registered Custom Post Types.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To configure the global Breadcrumbs behaviour, navigate to <strong>Customiser \u2192 General Options \u2192 Breadcrumbs<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Quick Look<\/h2>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"2056\" style=\"aspect-ratio: 3456 \/ 2056;\" width=\"3456\" autoplay loop muted src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2024\/03\/Screen-Recording-2024-03-22-at-13.49.20.mov\" playsinline><\/video><figcaption class=\"wp-element-caption\">An overview of the Breadcrumbs options in the Customiser.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Granular Controls<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The global Breadcrumbs panel controls the structure and information displayed inside Blocksy&#8217;s breadcrumb trail.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-995f960e wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:33.33%\">\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6aa97fb1407ee&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6aa97fb1407ee\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"1500\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2024\/03\/Screenshot-2024-03-22-at-13.50.47.png\" alt=\"Breadcrumbs configuration options in Blocksy\" class=\"wp-image-10032\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Global Breadcrumbs configuration options.<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:66.66%\">\n<ul class=\"wp-block-list\">\n<li><strong>Separator Style<\/strong> &#8211; choose the symbol displayed between individual breadcrumb items.<\/li>\n\n\n\n<li><strong>Home Item Display<\/strong> &#8211; display the home entry as text or use a home icon.<\/li>\n\n\n\n<li><strong>Current Page Visibility<\/strong> &#8211; choose whether the current page or entry is included at the end of the breadcrumb trail.<\/li>\n\n\n\n<li><strong>Taxonomy Title Inclusion<\/strong> &#8211; include the relevant category, tag or custom taxonomy title where supported.<\/li>\n\n\n\n<li><strong>Shop &amp; Blog Page Inclusion<\/strong> &#8211; include the dedicated Shop or Posts page in breadcrumb trails where those pages would otherwise be omitted from the hierarchy.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Displaying Breadcrumbs<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The global Breadcrumbs panel configures how breadcrumb trails behave, while their default visibility is controlled separately for each supported content type.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Open the relevant post type or archive panel in the Customiser, enter its <strong>Title<\/strong> section, and use the visibility control next to the <strong>Breadcrumbs<\/strong> element to show or hide it.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6aa97fb1417f6&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6aa97fb1417f6\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/05\/page-title-breadcrumbs-scaled.jpg\" alt=\"Breadcrumbs element inside the Single Posts title settings\" class=\"wp-image-5371\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Enabling the Breadcrumbs element for Single Posts.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Placing Breadcrumbs Manually<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Breadcrumbs Shortcode<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you need to place the breadcrumb trail somewhere other than its standard title-area location, Blocksy provides a shortcode that can be inserted into supported content areas:<\/p>\n\n\n\n<div class=\"wp-block-group has-palette-color-8-color has-palette-color-1-background-color has-text-color has-background is-layout-constrained wp-block-group-is-layout-constrained\">\n<p class=\"is-style-info coblocks-alert-paragraph wp-block-paragraph\"><strong>[ blocksy_breadcrumbs ]<\/strong><\/p>\n\n\n\n<p class=\"is-style-info coblocks-alert-paragraph wp-block-paragraph\">Add this shortcode wherever you want Blocksy&#8217;s breadcrumb trail to be rendered manually.<\/p>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">This is useful when building custom layouts where the standard Page Title placement does not match the desired design.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Breadcrumbs Block<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Blocksy also provides a dedicated <a href=\"https:\/\/creativethemes.com\/blocksy\/docs\/theme-blocks\/breadcrumbs-block\/\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>Breadcrumbs Block<\/strong><\/a> for the WordPress block editor. It can be inserted directly into posts, pages and custom templates wherever a block-based breadcrumb trail is preferred.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6aa97fb14253b&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6aa97fb14253b\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/05\/Screenshot-2023-05-08-at-17.22.25.png\" alt=\"Blocksy Breadcrumbs Block inside the WordPress block editor\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Adding the Breadcrumbs Block from the WordPress block editor.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Third-Party Breadcrumb Providers<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If your website already uses a dedicated SEO or breadcrumb plugin, Blocksy can use its breadcrumb output instead of the built-in provider.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Supported integrations include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Rank Math<\/strong><\/li>\n\n\n\n<li><strong>Yoast SEO<\/strong><\/li>\n\n\n\n<li><strong>SEOPress<\/strong><\/li>\n\n\n\n<li><strong>Breadcrumb NavXT<\/strong><\/li>\n<\/ul>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6aa97fb142d69&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6aa97fb142d69\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/05\/breadcrumbs-provider-selector-scaled.jpg\" alt=\"Breadcrumb provider selector in Blocksy\" class=\"wp-image-5372\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Selecting the provider used for breadcrumb output.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">When Blocksy detects a supported plugin, the corresponding provider becomes available under <strong>Customiser \u2192 General Options \u2192 Breadcrumbs<\/strong>. Selecting it lets Blocksy&#8217;s breadcrumb placements use the provider generated by that plugin.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Primary Taxonomy<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A post can belong to several categories or taxonomy terms, but you may want one particular term to represent the post within its breadcrumb hierarchy.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">SEO plugins such as Yoast SEO and Rank Math can provide a <strong>primary category<\/strong> or primary taxonomy option for this purpose. When available, open the post in the WordPress editor and select the preferred primary term from the taxonomy controls provided by the plugin.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6aa97fb1434df&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6aa97fb1434df\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2021\/05\/select-primary-taxonomy-scaled.jpg\" alt=\"Selecting a primary taxonomy term with an SEO plugin\" class=\"wp-image-5375\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Selecting a primary taxonomy term for a post.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The exact location and availability of this setting depends on the selected SEO plugin. If the option is not available, refer to that plugin&#8217;s documentation for its primary taxonomy configuration.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Blocksy&#8217;s Breadcrumbs system helps visitors understand where they are within your website&#8217;s hierarchy and provides a convenient way to navigate back through parent sections. Breadcrumbs are supported across posts, pages, archives, WooCommerce content and properly registered Custom Post Types. To configure the global Breadcrumbs behaviour, navigate to Customiser \u2192 General Options \u2192 Breadcrumbs. Quick Look [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[113],"class_list":["post-2403","documentation","type-documentation","status-publish","hentry","doc_categories-general-options"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":7}},"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/2403","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=2403"}],"version-history":[{"count":14,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/2403\/revisions"}],"predecessor-version":[{"id":15136,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/2403\/revisions\/15136"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=2403"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=2403"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}