Breadcrumbs Block – Navigation Trail

For classic themes, add <?= do_blocks('<!-- wp:x3p0/breadcrumbs /-->') ?> to your template files.
Do breadcrumbs help with SEO?
Yes. Breadcrumbs improve SEO by providing clear site structure to search engines, reducing bounce rates, and creating internal links. They also appear in Google search results when properly formatted, improving click-through rates.
Does this work with custom post types?
Yes. The plugin automatically detects all custom post types and taxonomies on your site and generates appropriate breadcrumbs for them without any configuration.
Can I customize the breadcrumb separator?
Yes. In the block settings panel, you can choose from several separator styles, including slash (/), arrow (→), bullet (•), chevron (›), and more.
How do I hide breadcrumbs on the homepage?
In the block settings panel, toggle off Show on homepage.
Can I show category breadcrumbs for blog posts?
Yes. In the block settings panel, select a taxonomy under the Post Taxonomies panel. You can choose the taxonomy for any post types registered on your site.
How do I add breadcrumbs to specific pages only?
Insert the Breadcrumbs block directly into individual page templates or use conditional logic in your theme templates to control where breadcrumbs appear.
Does the plugin support Schema.org markup?
Yes. The plugin includes three markup options: plain HTML, Schema.org microdata, and RDFa format. Developers can specify which format to use when implementing breadcrumbs via PHP.
How do I customize breadcrumb labels?
In the block settings panel, select the label you want to customize under the Labels panel. This provides a subset of common labels that you may want to modify.
Why don't my breadcrumbs show parent pages?
Make sure your pages are actually set as parent/child in the page editor. The plugin reads the page hierarchy from WordPress and displays it automatically.
Does this work with page builders?
Yes. You can insert the Breadcrumbs block into any page builder that supports WordPress blocks, including patterns and reusable blocks.
How do I add custom breadcrumbs for specific pages?
Developers can use the x3p0/breadcrumbs/resolve/query-type filter hook to implement custom breadcrumb logic for specific conditions.
Can I hide the current page from breadcrumbs?
Yes. In the block settings, toggle off Show last breadcrumb.
Is the plugin translation-ready?
Yes. The plugin is fully internationalized and has been translated into multiple languages. All labels and text can be translated using standard WordPress translation tools.
Can I style the breadcrumbs with CSS?
Yes. The breadcrumbs output standard HTML with CSS classes you can target. You can customize it with the common design tools available in the Site Editor or manually via theme.json.
Does it work with date-based permalink structures?
Yes. If your site uses date-based permalinks (e.g., /2025/10/post-name/), the plugin automatically generates breadcrumbs showing Home → Year → Month → Day → Post.
How do I display taxonomy breadcrumbs for custom post types?
In the block settings panel, select a taxonomy under the Post Taxonomies panel. Choose your custom post type and its associated taxonomy.
How do I troubleshoot breadcrumbs not appearing?
Check that:

The block is inserted in your template
Show on homepage is enabled if testing on homepage
Your theme doesn't have CSS hiding breadcrumbs
There are no PHP errors in your error log

Decide where breadcrumbs should appear. Most sites display them in the header, just below the site title and navigation menu, or at the top of the content area.

Step 2: Insert the Block

Navigate to Appearance → Editor, open your chosen template part, and insert the Breadcrumbs block using the block inserter.

Step 3: Configure Settings

Customize the block appearance using the settings panel. Choose your separator style, decide whether to show breadcrumbs on the homepage, and adjust visibility of the first and last items.

Step 4: Test Different Pages

Visit different page types (single posts, category archives, pages, search results) to see how breadcrumbs adapt to each context.