What is BreadcrumbList structured data?

It describes the path from your site's home page to the current page. Google can use it to replace the raw URL in search snippets with a readable breadcrumb trail, which looks cleaner and improves click-through.

How is the position field set?

Each ListItem needs a position starting at 1 and incrementing by one down the trail. This builder numbers positions automatically, so you cannot accidentally create gaps or duplicates.

Should the last crumb link to itself?

Google accepts the current page either with or without a self-referencing URL. This tool includes the URL for every item for consistency, which is valid and commonly used.

Can I have more than one breadcrumb trail?

Yes. A page reachable through multiple paths can include multiple BreadcrumbList objects in an array. For most pages a single trail is correct and simpler to maintain.

Do breadcrumbs need to be visible on the page?

Google recommends that the breadcrumb markup reflect a breadcrumb element visible to users. Marking up a trail that does not exist on the page can be treated as a structured-data violation.

JSON-LD BreadcrumbList Schema Builder

Email me this result

Get this tool's output sent to your inbox, plus one useful tool a week. No spam, unsubscribe any time.

The JSON-LD BreadcrumbList Schema Builder converts your page hierarchy into a valid schema.org/BreadcrumbList block. When Google uses it, the raw URL in your snippet becomes a clean, clickable trail such as Home > Guides > This Page, which reads better and earns more clicks.

How it works

The tool wraps each level of your trail in a ListItem object inside the itemListElement array. Every item carries a position (numbered automatically from 1 in order), a name for the visible label, and an item holding the page URL. Blank rows are skipped, and the positions are always renumbered so there are never gaps. The result is a single BreadcrumbList object with @context set to https://schema.org.

Tips and example

Order the rows from the top of your site (Home) down to the current page. Use absolute URLs so each crumb is crawlable. Keep the trail consistent with the breadcrumb a user actually sees on the page. A two-level trail produces this shape:

"itemListElement": [
  { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
  { "@type": "ListItem", "position": 2, "name": "Guides", "item": "https://example.com/guides" }
]

JSON-LD BreadcrumbList Schema Builder

Email me this result

Breadcrumb markup for tidy search snippets

How it works

Tips and example