S SCHEMA.BIZ

Last updated:

Breadcrumb Schema Generator

This breadcrumb schema generator turns the trail at the top of your page into BreadcrumbList JSON-LD. Add one row per level, from the top section down to the current page, give each a name and a URL, and the form numbers the positions for you. Copy the script tag into that page.

Reference: Breadcrumb schema

Breadcrumb: Use on any page below the top of your site to describe its place in the site's hierarchy. Google can show the trail in its desktop results.

Breadcrumbs

What Google shows for Breadcrumb markup

  • Breadcrumb: shown in Google Search; Google's last documented change was on January 22, 2025.

Google reads this markup to show where the page sits in your site, as a short trail in its result, and since January 2025 only in desktop results. It asks for a BreadcrumbList with at least two ListItems, each with a name and a position, plus an item address on every entry but the last. Without one on the last entry, Google takes the URL of the page that holds the markup. Valid markup makes the page eligible; Google decides whether the trail appears.

Google doesn't need a level for your domain or host name, nor one for the current page, and it recommends a trail that follows a typical path a visitor takes rather than the folders in the URL. Whatever you choose, list the levels the visible breadcrumb shows, in the same order.

How to fill in each field

Breadcrumb rows, in order

Each row under Breadcrumbs is one level. Press + Add Breadcrumb once per level and fill the rows from the top of the site down: row #1 becomes position 1, row #2 position 2, and so on, so you never type a position. Rows can't be dragged, so to change the order, edit their contents or remove a level and add it again. An empty row is skipped and the positions close up.

Name

Name is the label a reader sees in the trail, such as Guides, not the level's full page title with your site name attached. Copy the wording from the visible breadcrumb. A row with a URL but no name is still written, and the form reports it as an error, since Google needs a name for every level.

URL

URL is the level's own page as a full address, such as https://docs.example.com/guides/, even when your template's link is just /guides/. Google's examples all use full addresses, and the form and the Validator warn about a bare path. Use the address in that level's canonical tag, not one that redirects.

The last level

The last row is the page the markup goes on. Give it a name and leave its URL empty if you like: the form then writes no item for it, and Google uses the page's own address. Filling it in is fine too. Every row above it needs a URL; without one, the panel lists the breadcrumb under Not eligible yet.

The form marks 1 field as required and 0 as recommended:

  • Breadcrumbs (required): One row per level, from the top of the site down to this page. Google needs at least two. Every level but the last needs its URL.

Example: A help center article four levels deep

A documentation site's trail from the docs home to one article. The first three rows carry their URLs; the article, the last row, has a name only, so its ListItem has no item.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Docs",
      "item": "https://docs.tidewater.example/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Guides",
      "item": "https://docs.tidewater.example/guides/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Webhooks",
      "item": "https://docs.tidewater.example/guides/webhooks/"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Retrying failed deliveries"
    }
  ]
}

5 common mistakes

  1. A single row. Google needs at least two levels. A top-level section needs Home above it, or no breadcrumb markup at all.
  2. A trail the page doesn't show. If the visible breadcrumb reads Docs › Guides › Webhooks, the rows should read the same, in that order.
  3. Paths instead of full addresses. /guides/ works as a link on your site; in the markup, write the complete address.
  4. A middle level with no URL. Only the last row may leave URL empty. A level with no page of its own is better left out.
  5. Rows entered from the bottom up. Positions count from the first row, so a trail typed from the current page up comes out backwards.

How to test your Breadcrumb markup

While you type, the form's checks show errors such as a level with no name, and list Breadcrumb under Not eligible yet until the trail has two levels. Press Test in Google Rich Results to copy the code and open Google's test, then paste it into the Code tab. After you publish, test the live URL there or in the Schema Validator, and compare the trail it reports with the one on the page.

Frequently Asked Questions

Does the trail need a row for my home page?

No. Google doesn't require a level for your domain. Include Home when your visible breadcrumb starts with it; it also gives a short trail the two levels Google needs.

What if a page can be reached by more than one path?

Google allows several trails for one page. This form writes one BreadcrumbList at a time, so build each path on its own and add both script tags to the page. Mark up only the paths the page really shows.

Why don't I see breadcrumbs on my phone?

Since January 2025, Google shows breadcrumbs in desktop results only, so check for the trail in a desktop search.

Other schema generators