Breadcrumbs

Add breadcrumb navigation trails with Schema.org structured data for SEO. Shortcode or auto-display.

Overview

Breadcrumbs shows visitors where they are in your site hierarchy (for example Home › Blog › Guides › Article title). Trails appear on singular content such as posts and pages and reflect parent pages, categories, and other relationships WordPress already knows about. The module can emit Schema.org BreadcrumbList JSON-LD so search engines understand the same path, which can support rich result treatment where eligible.

You control placement in two ways: drop a shortcode where designers want the trail, or turn on automatic insertion before or after the main post content on singular views. Separators, optional styling hooks, and advanced options reduce the need for custom PHP while keeping output consistent with your theme.

Who is this for?

Editors and site owners whose navigation menus do not repeat the full depth of the site will appreciate on-page context, especially on deep URLs shared in social or email. SEO-minded teams that already use another plugin should coordinate so only one system outputs BreadcrumbList JSON-LD; this module is ideal when you want breadcrumbs plus schema in PowerSuite only. Developers can still override or theme the markup where needed, but many sitesenable the module, pick a separator, and use auto-insert to ship quickly on classic and block themes.

Features

Shortcodes

Use [breadcrumbs] or [wpps_breadcrumbs] to print the same renderer anywhere templates or the block editor allow shortcodes. Handy for custom page builders, full-site editing patterns, or widget areas.

Auto-Insert

Optional hooks add the trail before or after the_content on singular views so you do not edit hundreds of posts. You can scope behavior by post type in Advanced Settings where the module exposes those controls.

Separators and Presentation

Choose visual separators such as ›, /, >, or plain slashes to match brand guides. Module CSS provides a sensible baseline; themes can refine spacing and typography.

Structured Data (JSON-LD)

Where implemented, BreadcrumbList complements the visible trail so crawlers see a consistent hierarchy. Avoid enabling duplicate breadcrumb schema from another plugin.

Hierarchy Sources

Trails build from WordPress relationships: parent pages, categories, home URL, and post type archives when configured. Custom post types need public taxonomies and sensible parent links for full chains.

How It Works

Enable the Module

In WP PowerSuite, locate "Breadcrumbs" in the module list and enable it.

Open Advanced Settings

Set the separator, auto-insert mode (off, before content, after content), eligible post types, and any options that control schema or markup. Save.

Choose Placement Strategy

If auto-insert meets your design, publish and verify a few singular URLs. If not, turn auto-insert off and add the shortcode in templates or reusable blocks.

Validate Output

View page source or use Google Rich Results Test to confirm a single BreadcrumbList when schema is enabled. Visually confirm the trail matches real navigation.

Resolve Conflicts

If another plugin also prints breadcrumbs, disable one source for HTML or JSON-LD to prevent duplicates and conflicting hierarchy.

Performance Note

Rendering is lightweight: string assembly and optional schema on singular views only. No heavy queries beyond what WordPress already performs for the main query. Object and full-page caching do not usually require special rules unless you vary output by role or device in custom code.

Installation & Activation

Install WP PowerSuite

Ensure the main plugin is installed and activated.

Enable Breadcrumbs

From the WP PowerSuite screen, enable the Breadcrumbs module.

Configure Before Go-Live

Set separators and auto-insert, then check key templates (post, page, product if applicable).

De-Dupe SEO Plugins

Turn off duplicate breadcrumbs in Yoast, Rank Math, SEOPress, or similar if both visible trails and JSON-LD would double up.

Requirements

PHP 8.1 or higher WordPress 6.0 or higher Permission to manage options (Administrator)

Use Cases

CategoryDepth
Deep blogs with category and subcategory structures.

ProductHierarchy
WooCommerce or catalog sites with category → product paths.

DocHierarchy
Documentation sites mirroring handbook hierarchy on every article.

Breadcrumbs
Client sites where the editor wants “Home › Services › City” without coding.

Frequently Asked Questions

Can I use this together with Yoast or Rank Math breadcrumbs?
You can, but enable only one HTML trail and one JSON-LD BreadcrumbList. Two plugins emitting schema for the same URL can confuse validators and search consoles.
Why is part of my trail missing?
The chain depends on assigned categories, parent pages, and public post type settings. Private or non-hierarchical types may show shorter paths until you assign proper parents or terms.
Does it work with the block editor and full-site editing?
Yes. Shortcodes work in Shortcode blocks; auto-insert works on singular content regardless of editor, as long as the theme calls the_content.
Can I style breadcrumbs with my theme?
Yes. Use theme CSS targeting the module’s classes or wrappers documented in Advanced Settings or inspector output.
Will breadcrumbs show on the blog index or archives?
Auto-insert targets singular content by default. For archives, use theme templates or shortcodes where your theme supports them.

Troubleshooting

Trail missing links or “Home” only
Confirm the post has categories or a parent page, and that the post type is public. Flush permalinks after large structural changes.

Duplicate breadcrumbs on screen
Disable auto-insert or remove theme/plugin breadcrumbs so only one trail prints.

Schema errors in Rich Results Test
Ensure only one BreadcrumbList exists, URLs are absolute where required, and hierarchy order matches the visible trail.

Styled incorrectly on mobile
Inspect separator and flex rules; add small-screen CSS in your child theme without editing plugin files.

On This Page