Breadcrumbs Navigation Guide
Implement SEO-friendly breadcrumb navigation with schema markup for better user experience and search visibility
2025 SEO Update: Google now prefers JSON-LD structured data for breadcrumbs. While breadcrumbs no longer appear in mobile search results, they remain crucial for desktop SERPs and overall site navigation.
What are Breadcrumbs?
Breadcrumbs are a navigational aid that shows users their current location within your website's hierarchy. They appear as a trail of links, typically near the top of a page, showing the path from the homepage to the current page.
Example: Home › Blog › SEO Tips › Current Article
ProRank SEO's breadcrumbs feature provides automatic generation, customizable display options, and 2025-compliant structured data markup for optimal SEO performance.
Key Features
Automatic Generation
Intelligently creates breadcrumb trails based on your site structure
Schema Markup
JSON-LD and Microdata support for rich snippets in search results
Full Customization
Control appearance, separators, and display options
WooCommerce Ready
Built-in support for product hierarchies and shop pages
Quick Start
1. Enable Breadcrumbs
Navigate to WordPress Admin → ProRank SEO → On-Page SEO → Breadcrumbs
2. Configure Basic Settings
- Toggle Enable Breadcrumbs to ON
- Set your preferred Separator Style
- Customize the Home Text (default: "Home")
- Choose whether to show the current page in breadcrumbs
3. Choose Display Method
Option A: Automatic Insertion
Enable Auto Insert to automatically add breadcrumbs to all content. Choose position: Before or After content.
Option B: Manual Shortcode
Add breadcrumbs manually using the shortcode:
[prorank_breadcrumbs]4. Configure Schema Settings
Enable Schema Markup and select your preferred format (recommended: "Both" for maximum compatibility).
Display Settings
| Setting | Options | Description |
|---|---|---|
| Separator Style | Default (›), Arrow (→), Slash (/), Pipe (|) | Visual style for breadcrumb separators |
| Display Style | Inline, Background, Compact, Large | Overall appearance and spacing of breadcrumbs |
| Home Text | Customizable | Text displayed for the home/root link |
| Show Current Page | Yes/No | Whether to display the current page in trail |
| Show Home Link | Yes/No | Whether to include home link at start |
| Auto Insert | Before/After Content | Automatically add breadcrumbs to content |
Schema Markup Options
ProRank SEO supports multiple schema formats to ensure compatibility with all search engines and themes:
Both (Recommended)
Uses both Microdata and JSON-LD for maximum compatibility
JSON-LD Only
Modern structured data format preferred by Google in 2025
Microdata Only
Legacy format for older themes/plugins that may conflict
Supported Page Types
ProRank SEO automatically generates appropriate breadcrumbs for all WordPress page types:
| Page Type | Example Output | Features |
|---|---|---|
| Posts | Home › Category › Subcategory › Post Title | Full hierarchy with categories |
| Pages | Home › Parent Page › Child Page › Current Page | Complete page ancestry |
| Categories | Home › Parent Category › Current Category | Category hierarchy |
| Tags | Home › Tag Name | Simple tag breadcrumb |
| Custom Post Types | Home › CPT Archive › Category › Post | Full CPT support |
| WooCommerce Products | Home › Shop › Category › Product | Complete shop hierarchy |
| Archives | Home › 2025 › January | Date-based archives |
| Author Pages | Home › Author: John Doe | Author archives |
| Search Results | Home › Search Results for: query | Search pages |
| 404 Pages | Home › 404 Not Found | Error pages |
Shortcode Usage
The [prorank_breadcrumbs] shortcode supports various parameters for customization:
Basic Usage
[prorank_breadcrumbs]Custom Separator
[prorank_breadcrumbs separator="→"]Full Customization
[prorank_breadcrumbs separator="/" home_text="Start" show_current="false" style="slash" class="my-custom-breadcrumbs"]Available Parameters
| Parameter | Type | Description | Example | Default |
|---|---|---|---|---|
separator | string | Custom separator character | separator="→" | › |
home_text | string | Text for home link | home_text="Homepage" | Home |
show_current | boolean | Show/hide current page | show_current="false" | true |
show_home | boolean | Show/hide home link | show_home="false" | true |
style | string | Separator style (default, arrow, slash, pipe) | style="arrow" | default |
class | string | Additional CSS classes | class="my-breadcrumbs" |
Styling & Appearance
Display Styles
Inline (Default)
Simple, clean inline display
With Background
Highlighted with background color
Compact
Smaller text and spacing
Large
Bigger text for emphasis
Custom CSS
Add custom CSS in the settings or target these classes in your theme:
.prorank-breadcrumbs { /* Main container */ }
.prorank-breadcrumbs-list { /* The <ol> element */ }
.prorank-breadcrumb-item { /* Each breadcrumb item */ }
.prorank-breadcrumb-separator { /* Separator element */ }
.prorank-breadcrumb-current { /* Current page text */ }
/* Style variations */
.prorank-breadcrumbs.style-arrow { }
.prorank-breadcrumbs.style-slash { }
.prorank-breadcrumbs.style-pipe { }
.prorank-breadcrumbs.has-background { }
.prorank-breadcrumbs.style-compact { }
.prorank-breadcrumbs.style-large { }Display Location Settings
Control where breadcrumbs appear on your site:
✅ Enabled by Default
- • Posts
- • Pages
- • Archives
❌ Disabled by Default
- • Homepage
- • 404 Pages
You can customize these settings in the Breadcrumbs settings page under "Display Settings".
WooCommerce Integration
ProRank SEO automatically detects WooCommerce and provides enhanced breadcrumbs for:
- Shop Page: Home › Shop
- Product Categories: Home › Shop › Parent Category › Subcategory
- Single Products: Home › Shop › Category › Product Name
- Product Tags: Home › Shop › Tag Name
No additional configuration needed! WooCommerce breadcrumbs work automatically when both plugins are active.
Schema Markup Output
When schema is enabled, ProRank SEO generates structured data that helps search engines understand your site structure:
JSON-LD Output (Recommended)
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://example.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Blog",
"item": "https://example.com/blog/"
},
{
"@type": "ListItem",
"position": 3,
"name": "SEO Tips"
}
]
}Troubleshooting
Breadcrumbs not showing?
- • Ensure breadcrumbs are enabled in settings
- • Check if the current page type is enabled for display
- • If using shortcode, verify it's placed correctly
- • Clear any caching plugins after enabling
Duplicate breadcrumbs appearing?
- • Disable auto-insert if using manual shortcode
- • Check if your theme already includes breadcrumbs
- • Disable breadcrumbs in other SEO plugins if active
Wrong hierarchy displayed?
- • Ensure your content has proper categories assigned
- • Check page parent settings for hierarchical pages
- • Clear permalinks by visiting Settings → Permalinks
Developer Hooks
ProRank SEO provides filters for developers to customize breadcrumb output:
Filter breadcrumb trail array
add_filter('prorank_seo_breadcrumbs_trail', function($breadcrumbs, $args) {
// Modify breadcrumbs array
// Each item has 'name' and 'url' keys
// Example: Add custom item
$breadcrumbs[] = [
'name' => 'Custom Section',
'url' => 'https://example.com/custom/'
];
return $breadcrumbs;
}, 10, 2);Performance Note: Breadcrumbs are generated dynamically on each page load. If you have a high-traffic site, consider using a caching plugin to improve performance.
Best Practices
- Keep it Simple: Use clear, descriptive text for breadcrumb items
- Maintain Consistency: Use the same separator style throughout your site
- Mobile Optimization: Test breadcrumb display on mobile devices
- Use Schema Markup: Always enable structured data for SEO benefits
- Logical Hierarchy: Ensure your content structure makes sense to users
- Avoid Redundancy: Don't duplicate the page title in breadcrumbs