BreadcrumbList Schema Markup (JSON-LD Blueprint)
Hierarchical trail markup that replaces messy raw URLs in Google SERPs with elegant navigational breadcrumbs.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://omniseotools.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Tools",
"item": "https://omniseotools.com/tools"
},
{
"@type": "ListItem",
"position": 3,
"name": "Schema Validator",
"item": "https://omniseotools.com/tools/schema-validator"
}
]
}Typed Properties Specification (6 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| itemListElement | Array<ListItem> | Required | Ordered array of navigation hierarchy links. e.g. [{ "@type": "ListItem", ... }] |
| position | Integer | Required | 1-indexed integer representing depth in hierarchy. e.g. 1 |
| name | Text | Required | Label for the breadcrumb step displayed in SERPs. e.g. Tools |
| item | URL | Required | Canonical URL corresponding to that level. e.g. https://omniseotools.com/tools |
| numberOfItems | Integer | Recommended | Total depth levels in the current navigation breadcrumb trail. e.g. 3 |
| itemListOrder | URL | Recommended | Ascending order declaration (https://schema.org/ItemListOrderAscending). e.g. https://schema.org/ItemListOrderAscending |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying BreadcrumbList schema.
0-Indexed Position Sequence
Starting position at 0 instead of 1 violates Schema.org ListItem specification.
Always start breadcrumb positions at 1 (1, 2, 3...).
Missing Final Current Page ListItem
Omitting the current active page from the breadcrumb list creates a broken navigation trail.
Include the final page item matching the current canonical URL.
Relative URLs in item Field
Using relative paths like '/tools' instead of absolute HTTPS URLs.
Always supply full absolute URLs.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Technical SEO cluster.
Displayed below main page header or above the tool container. • Zero CLS Container