Skip to content
WP PowerSuiteWP PowerSuite Docs

Quick navigation

Popular modules

Browse by category

Security19/19Login & UserssoonAdminsoonContentsoonMediasoonSEO & VisibilitysoonSpeedsoonSite Toolssoon
↑↓ navigate↵ openesc close154 guides · 155 modules

Breadcrumbs

Breadcrumbs shows a clear “you are here” trail on posts and pages, with Schema.org BreadcrumbList markup for search engines.

What it does

Section titled “What it does”
  • Shortcodes: [breadcrumbs] and [wpps_breadcrumbs] (optional separator and home_text overrides).
  • Separator choices: ›, /, >, →, », |, ·.
  • Home Text label for the first crumb.
  • Auto Display: Manual (Use Shortcode), Before Content, or After Content.
  • Display On: public post types that receive auto-injected crumbs (default post and page).
  • Builds trails for singular posts (categories / parents), archives (category, tag, author, search, 404).
  • Skips the front page; outputs accessible <nav> + ordered list with itemprop markup.

When to use it

Section titled “When to use it”

Enable it if:

  • Themes lack breadcrumbs and you want a shortcode or auto inject.
  • You want BreadcrumbList schema without a full SEO suite.
  • Custom post types should show the same trail pattern as posts/pages.

When not to use it

Section titled “When not to use it”

How to enable it

Section titled “How to enable it”
  1. Go to WP PowerSuite -> Modules.
  2. Enable Breadcrumbs and open settings.
  3. Set Separator, Home Text, and Auto Display.
  4. Under Display On, choose which post types get auto crumbs.
  5. Or place [breadcrumbs] in content / do_shortcode('[breadcrumbs]') in a template.

How to test it

Section titled “How to test it”
  • Set Auto Display to Before Content for Posts; open a categorized post.
  • ✅ Pass: trail appears above content (Home › Category › Title) with schema attributes in the HTML.
  • Insert [breadcrumbs separator="/" home_text="Start"] on a page with Auto Display set to Manual.
  • ✅ Pass: shortcode renders with those overrides.
  • Open the site front page.
  • ✅ Pass: no breadcrumbs (front page is skipped).
  • ❌ Fail: confirm the post type is under Display On for auto mode.

Troubleshooting

Section titled “Troubleshooting”
  • Nothing shows. Trail needs more than Home alone; hierarchical parents or categories may be missing. Shortcode also returns empty on the front page.
  • Duplicate crumbs. Turn Auto Display to Manual and keep only the theme/plugin trail you want.
  • Wrong post types. Adjust Display On - auto inject only runs for selected singular types.

FAQ

Section titled “FAQ”
What does Breadcrumbs do?

It outputs a breadcrumb nav with Schema.org BreadcrumbList markup via [breadcrumbs] / [wpps_breadcrumbs] or Auto Display.

Is Breadcrumbs free?

Yes. Enable it under WP PowerSuite -> Modules.

How do I place breadcrumbs manually?

Use [breadcrumbs] or [wpps_breadcrumbs] in content or echo do_shortcode('[breadcrumbs]') in a theme template.

What does Auto Display control?

Manual (Use Shortcode), Before Content, or After Content on the post types selected under Display On.

How do I turn Breadcrumbs off?

Go to WP PowerSuite -> Modules, find Breadcrumbs, and toggle it off.

Developer notes (hooks & filters)

Source: modules/breadcrumbs/module.php. Boot: standard · context: frontend.

Shortcodes: breadcrumbs, wpps_breadcrumbs. Filter: the_content when auto_display is before or after. Settings: separator, home_text, auto_display, post_types.

Section titled “Related modules”