Breadcrumb Block


This is a single-block plugin for the breadcrumb trail. It’s simple, lightweight, SEO-friendly, and WooCommerce compatibility. It also includes some simple separator icons.

How to customize the breadcrumb

  1. How to change the markup of the block?

    add_filter( 'breadcrumb_block_get_breadcrumb_trail', function ( $markup, $args, $breadcrumbs_instance ) {
      return $markup;
    }, 10, 3 );
  2. How to add or remove the items from the breadcrumb trail?

    add_filter( 'breadcrumb_block_get_items', function ( $items, $breadcrumbs_instance ) {
      return $items;
    }, 10, 2 );
  3. How to use a custom separator for the breadcrumb trail?

    add_filter( 'breadcrumb_block_get_args', function ( $args ) {
      // For example, change separator.
      $args['separator'] = '<svg xmlns="" fill="currentColor" width="1em" height="1em" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M3.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L9.293 8 3.646 2.354a.5.5 0 0 1 0-.708z"/><path fill-rule="evenodd" d="M7.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L13.293 8 7.646 2.354a.5.5 0 0 1 0-.708z"/></svg>';
      return $args;
    } );

    The custom separator should be an inline SVG. To make sure it displays properly, it should have three attributes: width, height, and fill. The values of these attributes should be as follows: fill="currentColor" width="1em" height="1em".
    Using this hook, you can customize other attributes such as container, before, after, list_tag, item_tag, item_before, item_after, separator.

If this plugin is useful for you, please do a quick review and rate it on to help us spread the word. I would very much appreciate it.

Please check out my other plugins if you’re interested:

  • Content Blocks Builder – A tool to create blocks, patterns or variations easily for your site directly on the Block Editor.
  • Meta Field Block – A block to display a meta field or an ACF field as a block. It can also be used in the Query Loop block.
  • Block Enhancements – A plugin to add more useful features to blocks like icons, box-shadow, transform, hover style…
  • Icon Separator – A tiny block just like the core/separator block but with the ability to add an icon to it.
  • SVG Block – A block to insert inline SVG images easily and safely. It also bundles with more than 3000 icons and some common non-rectangular dividers.
  • Counting Number Block – A block to display a number that has the number-counting effect.
  • Better Youtube Embed Block – Embed Youtube videos without slowing down your site.

The plugin is developed using @wordpress/create-block.


Dieses Plugin unterstützt 1 Block.

  • Breadcrumb Block A simple breadcrumb trail block that supports JSON-LD structured data


  1. Upload the plugin files to the /wp-content/plugins/breadcrumb-block directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‚Plugins‘ screen in WordPress


What problem does this plugin solve?

It provides a simple way to add a breadcrumb trail to your site.

Who needs this plugin?

Anyone can use this plugin.


3. Feber 2024 1 reply
Does exactly what I expected - without superfluous features. It works very well. Thank you.
8. November 2023 1 reply
This just works, beautifully. Does exactly what you need and with filters, you can customize it quite easily. Great support as well. Highly recommend.
12. April 2023 4 replies
Awesome plugin, far easier than building it myself. Having the filters available makes modifications easy for me. For a regular user, backend settings might be easier though.
12. Feber 2023 1 reply
Great plugin, works flawlessly and does exactly what I need (I have a website with categories and subcategories for the locations for a paddle tour blog, so the user can change to the parent categories easily).
Lies alle 10 Rezensionen

Mitwirkende & Entwickler

„Breadcrumb Block“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:


Übersetze „Breadcrumb Block“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.



Release Date 22 September 2023

  • Added – A new hook breadcrumb_block_get_args for customizing the output of the breadcrumb.


Release Date 12 August 2023

  • DEV – Refactor block metadata and upgrade to apiVerion 3
  • DEV – Add a hook apply_filters( 'breadcrumb_block_strip_shortcodes', false, $breadcrumb_instance ) to allow opt-in/opt-out shortcodes in the post title. Thanks to Steven A. Zahm (
  • DEV – Add parent crumbs to other hierarchical post types. Thanks to Steven A. Zahm (
  • DEV – Add a hook apply_filters( 'breadcrumb_block_add_post_type_name', true, $post, $breadcrumb_instance ) to allow opt-in/opt-out post type name for custom post types
  • Fix – Conflict style with Bootstrap’s breadcrumb


Release Date 13 Apr 2023

  • DEV – Add a setting to input a custom home text


Release Date 24 Mar 2023

  • FIX – Error converting WP_Post_Type to string. Thanks to @tnchuntic for reporting it.


Release Date 20 Mar 2023

  • DEV – Make the block compatible with woocommerce


Release Date 11 Mar 2023

  • FIX – Add namespace to class_exists check


Release Date 12 Feb 2023

  • Add new hooks breadcrumb_block_home_text, breadcrumb_block_home_url


Release Date 05 Feb 2023

  • DEV – Add a setting to hide the home page link


Release Date 19 Jan 2023

  • FIX – Gap issue: adding the semicolon to the CSS variable
  • FIX – Could not modify breadcrumb data via the breadcrumb_block_get_items filter
  • DEV – Add a new arrow icon as a separator


Release Date 13 Dec 2022

  • DEV – Use post_type->labels->name instead of post_type->labels->singular_name for custom post type archive name
  • DEV – Add as @context for structured data
  • Note: Big thanks to Yannick for this release


Release Date 08 Dec 2022

  • DEV – Add a setting to hide the current page title


Release Date 01 Dec 2022

  • FIX – Syntax error on PHP version 7.0.0


Release Date 22 Oct 2022