Skip to content

Breadcrumb Schema Generator - JSON-LD for Google

Import existing JSON-LD

Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.

Breadcrumb Trail

Google Search Preview
Page Title
Page description will appear here with the breadcrumb trail shown above.
All Google requirements met

JSON-LD Output

What is Breadcrumb schema?

Breadcrumb schema is structured data that describes where a page sits in your site's hierarchy, such as Home, then Guides, then the current guide. It uses the schema.org BreadcrumbList type, which holds an ordered list of ListItem entries, each with a position, a name, and a URL. Google can use it to show a readable trail in place of the raw URL in search results.

The markup should mirror the breadcrumb navigation users can see on the page. Google's guidance is to build the trail around a typical path a user would take to the page, not to copy your URL folders one by one.

Breadcrumb schema example (JSON-LD)

A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Recipes",
      "item": "https://example.com/recipes/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Desserts",
      "item": "https://example.com/recipes/desserts/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Lemon Drizzle Cake"
    }
  ]
}
</script>

Which Google rich result does it enable?

Breadcrumb markup enables the breadcrumb trail shown above the title of a result, for example example.com › Recipes › Desserts. Google's documentation now lists the feature as available on desktop. On mobile, Google has moved to showing just the domain, so do not expect the trail on phones.

Bing also reads BreadcrumbList. The markup is cheap to add and helps search engines understand your site structure even where the trail is not displayed.

Required and recommended properties

Property Status Notes
itemListElement Required An ordered array of at least two ListItem objects.
ListItem.position Required Integer starting at 1 for the first item in the trail. The generator numbers items for you.
ListItem.name Required The label shown to users. Match the on-page breadcrumb text.
ListItem.item Required The URL of that breadcrumb page. You can leave it off the last item, and Google will use the current page URL.

Common Breadcrumb schema mistakes

  • Adding a single item. Google needs at least two ListItems for a valid trail.
  • Labels that differ from the visible breadcrumbs, such as Footwear in the markup and Shoes on the page.
  • Using relative URLs like /recipes/ in item. Use full absolute URLs.
  • Numbering positions from 0 or skipping numbers. Positions run 1, 2, 3 in order.
  • Pointing item at redirecting or non-canonical URLs, for example missing the trailing slash your site uses.

Pages with more than one path

If a product lives in two categories, you can add two separate BreadcrumbList objects to the same page, one for each path. Google picks the one that fits the search best. Do not merge both paths into a single list, because positions would no longer describe one trail.

Do you need a Home item?

Google says a ListItem for the home page is not required, since the domain already shows in the result. Include Home anyway if your visible breadcrumb starts with it; the markup should match what users see.

Related Tools

Frequently Asked Questions

Do breadcrumbs still show in Google results?
On desktop, yes: the trail appears above the title in place of the full URL. Since January 2025 Google shows only the domain on mobile, so the markup has no visible effect on phones.
How many breadcrumb items do I need?
At least two ListItems. Most trails have two to five. You can leave out the home page, since the domain already shows in the result, and the current page is optional too.
Does the position field matter?
Yes. Positions run 1, 2, 3 from the top of the trail. The generator assigns them from the order of the rows, so reorder the rows rather than editing numbers.
Should the last item have a URL?
It can go either way. If the last item is the current page, you can leave out item and Google uses the page's own URL.
Should the trail copy my URL folders?
No. Google asks for the path a typical user would take to reach the page. If /products/shoes/running/ is reached through a Sale category, the visible breadcrumb and the markup can say Sale > Running shoes.