How to Add Breadcrumb Schema

2 min read by Mohammad Shoeb

How to Add Breadcrumb Schema

Breadcrumb schema is the structured data that tells Google where a page sits in your site, so the search result shows a readable trail like Home > Blog > This Post instead of a bare URL. It is a small block of JSON-LD, and you can build a valid one in a couple of minutes.

What breadcrumb schema is

Breadcrumb schema uses a BreadcrumbList type with one property that matters: itemListElement. That property is an array of ListItem objects, each describing one step in the path from your homepage to the current page. Every ListItem has three parts:

  • position: the order of the step, starting at 1 for the homepage.
  • name: the visible label for that step, like “Blog” or “Headphones”.
  • item: the full URL that step links to.

The list runs in order from home to the current page. The last item, the page the visitor is actually on, can leave out the item URL since there is nothing left to link to. That is optional, but it is the common pattern.

Build it in four steps

  1. Open the Breadcrumb Schema Generator.
  2. Add one row per step, from your homepage down to the current page, in order.
  3. Fill in the name and URL for each step, matching the path a visitor would actually click.
  4. Copy the generated JSON-LD and paste it into the <head> of that page inside a <script type="application/ld+json"> tag.

The Breadcrumb Schema Generator handles the position numbering and JSON structure for you, so you only supply the names and URLs.

A quick example

A product page three levels deep produces something like this:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
    { "@type": "ListItem", "position": 2, "name": "Headphones", "item": "https://example.com/headphones/" },
    { "@type": "ListItem", "position": 3, "name": "Studio Pro" }
  ]
}

Notice position 3 has no item, because it is the current page.

Match your real site structure

The breadcrumb in your markup should mirror the navigation people see on the page. If your on-page trail reads Home > Headphones > Studio Pro, your schema should follow the same order with the same labels and the same URLs. A breadcrumb that points to pages that do not exist, or that disagrees with the visible path, can be ignored or flagged by Google. Keep position numbers sequential starting at 1, and use absolute URLs, not relative ones.

When you are done, paste the page URL or the JSON into Google’s Rich Results Test. It confirms the breadcrumb is valid and shows a preview of how the trail may appear in results. Fix any warnings it reports before you ship.

Map your path from home to the current page, generate the JSON-LD, and let Google show the trail instead of the URL.

SEOHow-to

← All posts