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. It works everywhere: Page Editor, Site Editor, and template files.<\/p>\n\n
How to change\/remove an item?<\/p>\n\n
add_filter( 'breadcrumb_block_get_item', function ( $item_args, $context, $breadcrumbs_instance ) {\n \/\/ Ignore items without context.\n if ( ! $context || ! ( $context['object'] ?? false ) ) {\n return $item_args;\n }\n\n \/\/ Eg: remove a term.\n if ( 'term' === ( $context['type'] ?? '' ) && 'term-slug' === $context['object']->slug ) {\n return false;\n }\n\n \/\/ Eg: Change the title of a page.\n if ( 'page' === ( $context['type'] ?? '' ) && page_id_to_change === $context['object']->ID ) {\n $item_args[0] = 'Make it shorter';\n }\n\n return $item_args;\n}, 10, 3 );\n<\/code><\/pre>\n\n$item_args is a 3-item array: [$item_label, $item_link, $item_attrs]<\/code>\n$context is an associative array: ['type' => 'item type', 'object' => 'item object']<\/code>. type<\/code> can be one of the following values: front_page<\/code>, home<\/code>, shop<\/code>, page<\/code>, post<\/code>, single<\/code>, term<\/code>, taxonomy<\/code>, post_type_archive<\/code>, search<\/code>, 404<\/code>, paged<\/code>, author<\/code>, date_year<\/code>, date_month<\/code>, date_day<\/code>, attachment<\/code>.<\/p><\/li>\nHow to change the markup of the block?<\/p>\n\n
add_filter( 'breadcrumb_block_get_breadcrumb_trail', function ( $markup, $args, $breadcrumbs_instance ) {\n return $markup;\n}, 10, 3 );\n<\/code><\/pre><\/li>\nHow to add or remove the items from the breadcrumb trail?<\/p>\n\n
add_filter( 'breadcrumb_block_get_items', function ( $items, $breadcrumbs_instance ) {\n return $items;\n}, 10, 2 );\n<\/code><\/pre><\/li>\nHow to use a custom separator for the breadcrumb trail?<\/p>\n\n
add_filter( 'breadcrumb_block_get_args', function ( $args ) {\n \/\/ For example, change separator.\n $args['separator'] = '<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" 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>';\n return $args;\n} );\n<\/code><\/pre>\n\nThe 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\"<\/code>.\nUsing this hook, you can customize other attributes such as container, before, after, list_tag, item_tag, item_before, item_after, separator.<\/p><\/li>\nHow to prepend the blog page to all single posts?<\/p>\n\n
add_action( 'breadcrumb_block_single_prepend', function ( $post, $breadcrumbs_instance ) {\n if ( 'post' === $post->post_type ) {\n $blog_id = get_option( 'page_for_posts');\n if ( $blog_id ) {\n $breadcrumbs_instance->add_item( get_the_title( $blog_id ), get_permalink( $blog_id ) );\n }\n }\n}, 10, 2 );\n<\/code><\/pre><\/li>\n<\/ol>\n\nIf this plugin is useful for you, please do a quick review and rate it<\/a> on WordPress.org to help us spread the word. I would very much appreciate it.<\/p>\n\nPlease check out my other plugins if you're interested:<\/p>\n\n
\n- Content Blocks Builder<\/a><\/strong> - Build custom layouts and blocks visually in the Block Editor without needing a code editor, using only core blocks and native Gutenberg features.<\/li>\n
- Meta Field Block<\/a><\/strong> - A single block to display custom fields in the Block Editor without coding. It supports ACF, MetaBox, WooCommerce, meta, rest field, shortcode and more. Works everywhere: in the Site Editor (FSE), the Block Editor, inside Query Loop, WooCommerce Product Collection, Term Query blocks, and even in template files.<\/li>\n
- SVG Block<\/a><\/strong> - A block to display SVG images as blocks. Useful for images, icons, dividers, and buttons. It allows you to upload SVG images and load them into the icon library.<\/li>\n
- Icon separator<\/a><\/strong> - A tiny block just like the core\/separator block but with the ability to add an icon.<\/li>\n
- Block Enhancements<\/a><\/strong> - Adds practical features to blocks like icons, box shadows, transforms, etc.<\/li>\n
- Counting Number Block<\/a><\/strong> - A block to display numbers with a counting effect<\/li>\n
- Better YouTube Embed Block<\/a><\/strong> - A block to solve the performance issue with embedded YouTube videos. It can also embed multiple videos and playlists.<\/li>\n<\/ul>\n\n
The plugin is developed using @wordpress\/create-block.<\/p>\n\n\n
\n- Upload the plugin files to the
\/wp-content\/plugins<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n- Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<\/ol>\n\n\n
\nWhat problem does this plugin solve?<\/h3><\/dt>\nIt provides a simple way to add a breadcrumb trail to your site.<\/p><\/dd>\n
Who needs this plugin?<\/h3><\/dt>\nAnyone can use this plugin.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.1.1<\/h4>\n\n
Release Date - 07 May 2026<\/em><\/p>\n\n\n- Improved - Updated instpector control style<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n
Release Date - 24 November 2025<\/em><\/p>\n\n\n- Improved - Revamped inspector settings and added more sepaprator icons<\/li>\n
- Added - UI for inputting labels<\/li>\n
- Added - Support for shadow<\/li>\n<\/ul>\n\n
1.0.16<\/h4>\n\n