Online Tool Store
· 2 min read
How to Generate Breadcrumb Schema JSON-LD
Heshan Fernando
Co-founder & COO
Breadcrumbs help people understand where a page sits in a site. Breadcrumb structured data does a similar job for search engines by describing the page trail in a machine-readable format. The markup is not complicated, but small mistakes in position numbers, URLs, or item names can make it invalid.
A breadcrumb schema generator helps you build JSON-LD for breadcrumb trails without hand-writing every ListItem.
What breadcrumb schema involves
Breadcrumb schema usually uses Schema.org’s BreadcrumbList type. Each step in the trail is a ListItem with a position, name, and URL. The order matters because it describes the path from the broadest page to the current page.
JSON-LD is commonly used because it can be placed in a script tag without changing visible page markup.
Why people get stuck here
Breadcrumbs are repetitive. If you hand-code them, it is easy to duplicate a position, skip a level, or paste the wrong URL. On large sites, that creates inconsistent structured data across templates.
Another issue is mismatch. The structured data should reflect the visible breadcrumb trail and the real page hierarchy.
| Breadcrumb Field | What It Represents |
|---|---|
| Position | Order in the trail |
| Name | Human-readable label |
| Item URL | Canonical page for that step |
| BreadcrumbList | Container for the trail |
What good breadcrumb JSON-LD looks like
Positions are sequential
Each step should count upward from 1 with no duplicates.
URLs are canonical
Use the preferred page URL, not tracking links or temporary paths.
Labels match the visible trail
Structured data should not describe a different navigation path than users see.
Common mistakes to avoid
- Skipping position numbers. Breadcrumb items should be ordered clearly.
- Using relative URLs where absolute URLs are expected. Canonical absolute URLs are usually safer.
- Adding pages that are not in the visible trail. Keep markup and UI aligned.
- Forgetting to validate. Structured data should be tested before deployment.
How to do it with Breadcrumb Schema Generator
- Open the free Breadcrumb Schema Generator.
- Enter each breadcrumb label in order.
- Add the matching canonical URL for each step.
- Generate the JSON-LD output.
- Review the positions and paste the markup into your page or template.
The tool is useful when drafting schema for static pages, blog posts, documentation, or ecommerce categories.
Frequently asked questions
What format does breadcrumb schema use?
JSON-LD is a common format because it is easy to add in a script tag.
Should breadcrumb schema match visible breadcrumbs?
Yes. The structured data should represent the same path users can understand on the page.
Do breadcrumbs guarantee rich results?
No. Structured data makes the page eligible for certain interpretations, but search engines decide how to display results.
Final thought
Breadcrumb schema is simple but fussy. Generate it carefully, keep it aligned with the visible trail, and validate before publishing.