You add WP Breadcrumbs to your site. Breadcrumbs show only “Home.” No page hierarchy. That is frustrating because users cannot navigate.
A common issue is that the plugin does not detect page parents correctly. Or permalink structure is missing. The plugin is not broken. Hierarchy detection failed.
Why WP Breadcrumbs Shows Only Home Link
WP Breadcrumbs builds path based on page hierarchy, post categories, or custom taxonomies. If page has no parent, breadcrumb shows only Home. If post has no category, breadcrumb shows only Home. If permalink structure is flat, no hierarchy.
This is not WP Breadcrumbs being bad. Content has no hierarchy.
The Most Common Breadcrumb Failures
- Page has no parent (top-level page)
- Post has no category assigned
- Custom post type has no archive page
- Permalink structure set to Plain
- Plugin not configured for custom post types
Add hierarchy to content.
How to Fix WP Breadcrumbs Hierarchy
- Assign parent pages (Page Attributes → Parent Page)
- Assign categories to posts
- Set permalink structure to Post Name (Settings → Permalinks)
- Go to WP Breadcrumbs → Settings → Custom Post Types
- Enable breadcrumbs for each post type
- Set custom taxonomy for breadcrumb path
Parent pages create hierarchy.
How to Add Custom Breadcrumb Hierarchy for Posts
Add this code to functions.php:
add_filter('wp_breadcrumbs_hierarchy', function($crumbs) {
$categories = get_the_category();
if ($categories) {
array_unshift($crumbs, get_category_parents($categories[0]->term_id, false, '/'));
}
return $crumbs;
});
This adds category hierarchy to breadcrumbs.
Alternative: Use Yoast SEO Breadcrumbs
If WP Breadcrumbs fails, enable Yoast SEO breadcrumbs. More reliable. Better hierarchy detection. Built-in caching.
Yoast breadcrumbs work out of box.
People Also Ask About Breadcrumbs Problems
Why do my breadcrumbs show only Home?
Content has no hierarchy. Assign parent pages or categories.
Should I stop using WP Breadcrumbs?
Assign parent pages. Breadcrumbs will show full path.
Is WP Breadcrumbs worse than Yoast Breadcrumbs?
Yoast has better auto-detection. Consider switching.
Final Thoughts
If WP Breadcrumbs shows only Home, assign parent pages to pages. Add categories to posts. Permalink structure must be Post Name. Breadcrumbs will show full navigation path.