Generate valid BreadcrumbList JSON-LD structured data for any page. Map the path from your homepage down to the current page and copy the markup. Free, no sign-up required.
Add at least one breadcrumb name above and your JSON-LD will build here automatically.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": []
}
</script><head> section of the page this trail describes.Breadcrumb markup tells search engines how your pages connect. These free widgets make the site easier to move around for real visitors.
Group related pages into clean, collapsible sections so visitors find their way around fast. Clear on-page structure backs up the hierarchy your schema describes.
Split a busy landing page into tabs so people jump straight to the section they need. Tidy structure reinforces the path signals your breadcrumbs send.
Pull your latest content into a clean feed so deeper pages stay one tap away. A well-connected site helps search engines map your hierarchy.
Lay out options side by side so visitors compare and decide on the page they landed on. Clear structure supports the trail your markup defines.
Other free tools to help you optimize and grow.
Generate Organization, WebSite, and LocalBusiness JSON-LD structured data for your whole site.
Use Tool →Generate Article, BlogPosting, and NewsArticle JSON-LD structured data for your posts.
Use Tool →Generate valid FAQ Page JSON-LD structured data to earn FAQ rich results.
Use Tool →Generate title, description, and social meta tags for any page in seconds.
Use Tool →Generate SEO-friendly URL slugs from any title or text.
Use Tool →How It Works
No account needed, no sign-up, completely free. List the path to your page, and valid JSON-LD structured data builds live, ready to copy into your page.
Add one row for each level of the path, from your homepage down to the current page. Type the name a visitor would recognize, like Home, then the category, then the page they are on.
Paste the absolute URL for each crumb. The last one, the current page, can keep its URL or leave it blank. Everything you type builds the markup live, with no empty rows left in.
Copy the generated JSON-LD, paste it into the head of the page, and confirm it with the Google Rich Results Test. No sign-up, completely free.
The Basics
Search engines read your pages, but structured data tells them exactly how a page fits into your site: the path a visitor takes from your homepage down to the page they land on.
The idea
Homepage → Category → Current page → JSON-LD in your <head>
Result: search engines and searchers see where your page sits
Breadcrumb schema is structured data that describes the path to a page using the shared schema.org vocabulary. Instead of hoping Google infers your site structure from links and URLs, you state the trail explicitly in a format built for machines to read.
The recommended format is JSON-LD: a small block of JSON placed in the head of the page. It lives separately from your visible content, so it is easy to add without touching your design. Each level of the path becomes a ListItem with a position, a name, and usually a URL.
Structured data does not guarantee rankings or rich results, but a clear breadcrumb trail makes your site structure unambiguous to search engines and to the AI assistants that increasingly summarize the web. Clear data means your pages are easier to place, and describe, correctly.
The Fields
A breadcrumb block is small. Here is what each piece means and when it comes into play.
| Field | What it does | When it applies | Role |
|---|---|---|---|
| BreadcrumbList | The wrapper type that says this block describes a breadcrumb trail. | Every breadcrumb block. It holds the list of items. | Type |
| ListItem | One step in the trail. You get one ListItem per level in your path. | One per breadcrumb, from homepage to current page. | Item |
| position | The order number of the step, starting at 1 for the first crumb. | Must count up in order, with no gaps. | Order |
| item | The absolute URL of that step. Can be left off the final, current page. | On every step except optionally the last. | URL |
Based on the schema.org BreadcrumbList type supported by Google Search, 2026.
What It Can Unlock
Structured data makes your pages eligible for search features and helps machines understand your site. Eligibility is never guaranteed, but the groundwork matters.
Valid BreadcrumbList markup can replace the plain URL in search results with a readable path, so people see where the page sits before they click.
Breadcrumbs state how your pages relate to one another, which helps search engines understand the structure of your site.
A clear path from homepage to page gives crawlers extra context about how deep a page sits and how it is reached.
On phones, a breadcrumb path is easier to read than a long, truncated URL, which can make your result more inviting to tap.
Structured breadcrumb data makes it easier for AI answer engines to place your page in context and describe it accurately.
Breadcrumbs reinforce the internal links between your homepage, categories, and pages, keeping your structure consistent.
Avoid These
Structured data helps only when it is accurate and valid. Steer clear of these common errors.
The trail in your schema must follow the actual route to the page, from homepage down. A jumbled order confuses both people and search engines.
Follow the real pathPositions must start at 1 and count up with no gaps or repeats. A broken sequence can invalidate the whole block.
Number 1, 2, 3 in orderUse full, absolute URLs like https://www.example.com/category, not partial paths. Relative URLs can fail validation.
Use absolute URLsDo not add a breadcrumb trail in markup that does not exist on the page. Google expects the schema to match what visitors actually see.
Match the visible pageAlways run your markup through the Rich Results Test and Schema.org Validator. A single syntax slip can invalidate the whole block.
Validate before you shipEach page needs its own breadcrumb trail reflecting its own path. Reusing one generic trail everywhere misrepresents your structure.
One trail per pageGet More From It
Practical ways to make your schema work harder. All CommonNinja widgets mentioned are free to start.
The first crumb should almost always be your homepage. It anchors the trail and mirrors how a visitor would reach the page.
Google allows omitting the URL of the current page, since a visitor is already on it. Include it if you like, or leave it blank without breaking the markup.
If your page shows a breadcrumb bar, the schema should mirror it exactly, same names, same order. Consistency keeps the markup trustworthy.
Breadcrumbs describe one path. Your Organization and WebSite schema describes the whole brand. Use both. Our free Website Schema Generator builds the site-wide part.
Try the Website Schema Generator →Schema describes structure; make the on-page version just as clear. Tabs and accordions organize a busy page cleanly for the humans who arrive from search.
Try the Tabs widget →Re-run the Rich Results Test whenever you edit a trail or restructure your site. It catches errors before Google does.
Glossary
A quick reference for the properties behind breadcrumb markup.
| Field | Definition | Example | When It Matters |
|---|---|---|---|
| BreadcrumbList | The schema.org type for a breadcrumb trail. It wraps an ordered list of the steps that lead to the page. | The whole block | Every page you mark up |
| itemListElement | The ordered array of steps inside the list. Each entry is one ListItem describing a level of the path. | Array of ListItems | Always, one entry per crumb |
| position | The order number of a step, starting at 1. It must count up in sequence with no gaps. | 1, 2, 3 | Every step in the trail |
| name | The readable label for a step, like Home or Blog. It should match what a visitor sees on the page. | Home | Every step in the trail |
| item | The absolute URL for a step. Optional on the final, current page since the visitor is already there. | https://www.example.com/blog | Every step except optionally the last |
From the Blog
Go deeper on technical SEO, site structure, and making your content easier for search engines to understand.
In this comprehensive guide, we will delve into the intricacies of effective website navigation. ...
Read article →In this article, we are going to discuss SEO, explain why it’s important to the success of a website, and suggest ways t...
Read article →In this article, we will look at some important SEO factors to consider when building a website, for the purpose of incr...
Read article →In this article, we discuss the importance of readability in SEO, highlighting its impact on search engine rankings, use...
Read article →In this article, we explore how SEO enhances Instagram visibility, focusing on optimizing profiles with keywords, strate...
Read article →In this article, we discuss image compression's benefits for web performance and SEO, highlighting faster load times and...
Read article →