ProRank SEO

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

SettingOptionsDescription
Separator StyleDefault (›), Arrow (→), Slash (/), Pipe (|)Visual style for breadcrumb separators
Display StyleInline, Background, Compact, LargeOverall appearance and spacing of breadcrumbs
Home TextCustomizableText displayed for the home/root link
Show Current PageYes/NoWhether to display the current page in trail
Show Home LinkYes/NoWhether to include home link at start
Auto InsertBefore/After ContentAutomatically 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 TypeExample OutputFeatures
PostsHome › Category › Subcategory › Post TitleFull hierarchy with categories
PagesHome › Parent Page › Child Page › Current PageComplete page ancestry
CategoriesHome › Parent Category › Current CategoryCategory hierarchy
TagsHome › Tag NameSimple tag breadcrumb
Custom Post TypesHome › CPT Archive › Category › PostFull CPT support
WooCommerce ProductsHome › Shop › Category › ProductComplete shop hierarchy
ArchivesHome › 2025 › JanuaryDate-based archives
Author PagesHome › Author: John DoeAuthor archives
Search ResultsHome › Search Results for: querySearch pages
404 PagesHome › 404 Not FoundError 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

ParameterTypeDescriptionExampleDefault
separatorstringCustom separator characterseparator="→"
home_textstringText for home linkhome_text="Homepage"Home
show_currentbooleanShow/hide current pageshow_current="false"true
show_homebooleanShow/hide home linkshow_home="false"true
stylestringSeparator style (default, arrow, slash, pipe)style="arrow"default
classstringAdditional CSS classesclass="my-breadcrumbs"

Styling & Appearance

Display Styles

Inline (Default)

Simple, clean inline display

Home › Category › Page

With Background

Highlighted with background color

Home › Category › Page

Compact

Smaller text and spacing

Home › Category › Page

Large

Bigger text for emphasis

Home › Category › Page

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