Free Breadcrumb Schema Generator (BreadcrumbList JSON-LD)

Breadcrumb schema replaces the ugly URL Google shows below your search snippet with a clean, clickable navigation path. Instead of "yoursite.com/category/subcategory/product-name," users see "Home › Shoes › Running › Nike Pegasus." It looks more professional, increases click-through rates, and signals site structure to Google. Our free generator builds BreadcrumbList JSON-LD — no plugin needed.

What Breadcrumb Schema Does in Search

Without breadcrumb schema, Google shows your URL as a string. With it, Google shows a clean navigation path — the same path users would walk if they navigated through your site. This visual change has measurable impact:

• Higher click-through rates (cleaner snippets are more clickable)
• Better crawl efficiency (Google understands your site hierarchy faster)
• Stronger internal page signal (Google knows which pages are parents of which)
• Mobile-friendlier display (long URLs get truncated; breadcrumbs don't)

Adding breadcrumb schema is one of the lowest-effort, highest-impact pieces of structured data. Five minutes to generate and paste; permanent improvement in how your pages appear in search.

BreadcrumbList Structure: An Ordered ListItem Array

BreadcrumbList is one of the simpler schema types. It's an ordered array of ListItem objects, each with three fields:

• position — number starting at 1 (the position in the breadcrumb path)
• name — the breadcrumb label (what users see)
• item — the URL of that breadcrumb level

For a product page at yoursite.com/category/subcategory/product/, the breadcrumb list would be:

1. Home — yoursite.com
2. Category — yoursite.com/category/
3. Subcategory — yoursite.com/category/subcategory/
4. Product Name — yoursite.com/category/subcategory/product/ (the current page)

The current page is the last item. Don't omit it — Google expects the full path including the page itself.

Multiple Breadcrumb Paths for the Same Page

If a page can be reached through multiple navigation paths (e.g., a product that lives in two different categories), you can add multiple BreadcrumbList entries to the same page. Use an array of BreadcrumbList objects in your schema, each representing a different valid path.

Google may choose any of them to display in search results. Usually it picks the shortest or most relevant path for the user's query. There's no penalty for having multiple breadcrumb paths — it's actually a positive signal that the page is well-connected.

Don't go overboard. Two or three paths max. Five paths starts to look like manipulation rather than legitimate navigation.

Sell Custom Apparel — We Handle Printing & Free Shipping

Schema Breadcrumbs Should Match Visible Breadcrumbs

The breadcrumbs in your schema should match the breadcrumbs visible to users on the page. Don't use schema-only breadcrumbs that don't appear anywhere in the actual HTML — Google may flag this as misleading.

If your site doesn't have visible breadcrumbs, add them. They're a usability win for users (especially on mobile), and they reinforce the schema. Most CMS themes have a built-in breadcrumb component — Yoast, Rank Math, Shopify Dawn, Webflow, and Squarespace all support visible breadcrumbs out of the box.

Once visible breadcrumbs exist, add the schema. The combination is what makes Google confident enough to use the schema in search results.

Why Breadcrumb Schema Sometimes Doesn't Show in Search

You add breadcrumb schema, validate it, deploy it, and weeks later Google still shows the URL. Common reasons:

• Schema URLs don't match canonical URLs. If your canonical URL is yoursite.com/page/ but your breadcrumb item URL is yoursite.com/page (no trailing slash), Google may reject the breadcrumb. Match exactly.
• The current page item is missing. The last breadcrumb (the page itself) must be included with the page's full URL.
• Position numbers aren't sequential. Position should start at 1 and increment by 1. Skipping numbers breaks parsing.
• Breadcrumb names are too long. Keep them under 30 characters per item. Long names get truncated awkwardly.
• The page has too many breadcrumbs. 3-5 levels is the sweet spot. More than 5 starts to look spammy.

If you've checked all of these and the schema still isn't showing, give it 4-8 weeks. Google sometimes takes a while to start using new schema even when it's valid.

Adding Breadcrumb Schema Across an Entire Site

You don't want to manually generate breadcrumbs for every page. The pattern that scales: build the schema dynamically based on your URL structure.

WordPress: Most SEO plugins (Yoast, Rank Math) generate breadcrumb schema automatically based on your site structure. If you don't want a plugin, write a function in your child theme that parses the current URL into breadcrumb segments and outputs the JSON-LD in the head.

Shopify: Edit theme.liquid and use Liquid to generate breadcrumbs from the current page's collection and product handles. The pattern is well-documented in Shopify community forums.

Next.js / React frameworks: Build a Breadcrumb component that takes the current page path and renders both visible HTML breadcrumbs and a script tag with the JSON-LD. Use it in your layout.

Static sites: Generate breadcrumbs at build time from your site's directory structure. Most static site generators have a plugin or template for this.

For a one-off page or a test, just use the generator and paste the result. For production sites with hundreds of pages, automate it.

Frequently Asked Questions

Do I need visible breadcrumbs on the page, or is schema enough?

You should have both. Schema-only breadcrumbs (no visible breadcrumbs on the page) can be flagged as misleading by Google. Visible breadcrumbs reinforce the schema and provide a usability benefit. Most CMS themes support visible breadcrumbs out of the box.

How many breadcrumb levels should I have?

Three to five is the sweet spot. Two levels is too shallow to be useful. Six or more starts to look spammy and gets truncated in search results anyway. If your site has deep hierarchies, prioritize the most relevant path.

Should the current page be included in the breadcrumb list?

Yes. The current page is the last item in the BreadcrumbList. Don't omit it. Google expects the full path including where the user is now.

Can a page have multiple breadcrumb paths?

Yes. Use an array of BreadcrumbList objects. This is useful when a product or article belongs to multiple categories. Google can choose the most relevant path for each search query. Limit to 2-3 paths max.

Does breadcrumb schema affect ranking?

Indirectly. It doesn't directly boost rankings, but it improves click-through rates (cleaner snippets get more clicks), helps Google crawl your site structure, and contributes to overall site quality signals. The CTR boost alone makes it worth adding.

What's the most common breadcrumb schema mistake?

URL mismatch — the URLs in the breadcrumb items don't match the canonical URLs on the actual pages. A trailing slash difference, http vs https, or www vs non-www inconsistency causes Google to reject the breadcrumb. Match exactly.