Breadcrumb Schema Generator — Free JSON-LD

What is BreadcrumbList Schema?

BreadcrumbList is the Schema.org type representing a hierarchical navigation path through your site. When implemented as JSON-LD, search engines render the breadcrumb trail in place of (or alongside) the URL in search results — making your listing clearer about where the page sits in your site structure.

BreadcrumbList is one of the few schema types that produces a directly visible SERP enhancement on almost every qualifying page. It's also one of the simplest to implement — typically 5-10 lines of JSON-LD per page. The CTR uplift is consistent and measurable.

Why BreadcrumbList Schema Matters

• URL replacement in SERPs: Google substitutes the breadcrumb path for the raw URL on mobile and frequently on desktop. "yoursite.com > Shoes > Running" reads cleaner than the raw URL.
• CTR uplift: Studies consistently show 5-15% CTR improvement on pages with valid breadcrumb schema vs without — purely from the visual change in SERP listing.
• Hierarchical context: Breadcrumbs help users understand where a result sits in your site, reducing pogo-sticking and improving session quality.
• Internal link signal: Each level of the breadcrumb is also a real link on your page (if you implement visible breadcrumbs alongside schema). This strengthens internal linking authority to category pages.
• Mobile SERP optimization: Mobile search devotes limited horizontal space to URL display — breadcrumbs use that space far more effectively than raw URLs.
• Sub-pages of category trees: For ecommerce, content sites with category structures, and documentation, breadcrumb schema is essentially mandatory for proper SERP rendering.

BreadcrumbList Schema Properties Explained

Required Properties

• itemListElement: Ordered array of ListItem objects. Each represents one level in the hierarchy.

Per-ListItem Properties

• position: Integer starting from 1, incrementing per level (1 = top, max usually 5).
• name: Display name for that level (e.g., "Shoes", "Men's", "Running Shoes").
• item: Absolute URL to the page representing that level. Omit on the final (current) item.

Step-by-Step Implementation

Step 1: Map Your Site Hierarchy

Before generating, identify the breadcrumb path for the page you're marking up. Typical pattern: Home → Category → Subcategory → Current Page. Keep it to 3-5 levels — anything deeper signals over-complex navigation.

Step 2: Match Schema to Visible Breadcrumbs

Best practice is to also render a visible breadcrumb component on the page that matches the schema exactly. This avoids the "schema doesn't match visible content" warning in Search Console.

Step 3: Use Absolute URLs

Each item URL must be absolute (https://yoursite.com/category) not relative (/category). Relative URLs fail validation and may break SERP rendering.

Step 4: Order Correctly

position starts at 1 for the top level (usually Home) and increments. The order in itemListElement determines render order. Don't reverse the order — Google reads top-to-bottom.

Step 5: Omit URL on Last Item

The final ListItem (representing the current page) should have a name but no url property. The current page isn't a link from itself.

BreadcrumbList Schema Best Practices

• Always render visible breadcrumbs that match the schema — improves both UX and validation.
• Use plain, descriptive names — "Shoes" not "Shoes Category Page".
• Start with "Home" or your brand name at position 1 (helps establish the root).
• Keep depth at 3-5 levels max — beyond that, the SERP rendering gets cluttered.
• Match the name in breadcrumb schema to the name in the linked page's title tag.
• Include breadcrumb schema on every indexed page except the homepage.
• Use consistent breadcrumb structure across templates (every product page follows the same hierarchy pattern).

Common Mistakes to Avoid

• Including a URL on the final (current page) ListItem.
• Using relative URLs instead of absolute.
• Schema with 8+ levels — Google truncates SERP rendering at 3-4 levels visible.
• Breadcrumb schema that doesn't match visible breadcrumbs on the page.
• Reusing the same BreadcrumbList across many pages without updating per-page hierarchy.
• Missing position numbers or non-sequential numbering.
• Adding BreadcrumbList to the homepage (it has no parent).

Frequently Asked Questions

Related Schema Generators

• Organization Schema Generator — pair Breadcrumb with Organization on every indexed page.
• Article Schema Generator — Articles especially benefit from breadcrumbs showing topic hierarchy.
• Product Schema Generator — Products in deep category trees rely heavily on breadcrumbs.