Breadcrumb Schema Generator
Generate BreadcrumbList JSON-LD markup for structured breadcrumbs.
Back to all tools on ToolForge
Enter one breadcrumb per line using the format: Name :: URL
About Breadcrumb Schema Generator
This breadcrumb schema generator creates BreadcrumbList JSON-LD structured data compliant with schema.org standards. It helps search engines understand your site's hierarchical navigation structure, potentially displaying friendly breadcrumb navigation in Google search results instead of full URLs.
BreadcrumbList Structure
- BreadcrumbList: Root type containing the entire breadcrumb list
- itemListElement: Array containing all breadcrumb items
- ListItem: Type for each breadcrumb item
- position: Position in the path (starts from 1)
- name: Label text displayed to users
- item: Full URL that the item points to
Generated JSON-LD Example:
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://example.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Blog",
"item": "https://example.com/blog/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Tech Articles",
"item": "https://example.com/blog/tech/"
}
]
}
Input Format
Enter one breadcrumb item per line using Name :: URL format:
Input Example: Home :: https://example.com/ Products :: https://example.com/products/ Electronics :: https://example.com/products/electronics/ Phones :: https://example.com/products/electronics/phones/ Line structure: Label Name :: Full URL Order: From homepage to current page
SEO Best Practices
| Requirement | Description |
|---|---|
| Match page navigation | Structured data must match visible breadcrumb links on the page |
| Use absolute URLs | Item field must contain complete URL (including protocol) |
| Minimum two items | BreadcrumbList must contain at least two ListItems |
| Sequential positions | Position numbers must start from 1 and increment sequentially |
| Homepage URL optional | Item field can be omitted for the homepage breadcrumb |
Common Use Cases
- E-commerce sites: Display category hierarchy (Home > Category > Subcategory > Product)
- Blogs/News: Article paths (Home > Section > Article Title)
- Documentation sites: Documentation hierarchy (Home > Chapter > Page)
- Forums: Board navigation (Home > Section > Board > Topic)
- Corporate websites: Page hierarchy (Home > About Us > Our Team)
Validation Tools
After deploying breadcrumb structured data, use these tools to validate:
- Google Rich Results Test: Test compliance with Google rich results requirements
- Schema Markup Validator: Official schema.org validation tool
- Google Search Console: Monitor structured data status and errors
Common Errors and Solutions
| Error | Impact | Solution |
|---|---|---|
| Missing position field | Validation failure | Add position field to each ListItem |
| Using relative URLs | Google may ignore | Use complete absolute URLs |
| Only one item | Does not meet requirements | Include at least two items |
| Mismatch with page navigation | May be downweighted | Keep structured data consistent with visible navigation |
How to Use Breadcrumb Schema Generator
- Enter breadcrumb items: Input one item per line in "Label Name :: URL" format.
- Verify order: Start from homepage, proceed to current page.
- Click Generate: Tool generates schema.org compliant JSON-LD code.
- Copy and use: Place generated code in your webpage's head or body.
- Validate: Test deployment with Google Rich Results Test.
Tips
- Each line must contain "::" separator with label before and URL after
- URLs must be complete format (including https://)
- Position values auto-increment starting from 1
- Minimum of two breadcrumb items required
- Last URL can be current page or omitted
Frequently Asked Questions
- What is Breadcrumb Schema (BreadcrumbList)?
- Breadcrumb Schema is a structured data type defined by schema.org as BreadcrumbList. It displays hierarchical navigation paths to search engines. The structure consists of an itemListElement array where each ListItem contains position (integer starting from 1), name (breadcrumb label), and item (full URL).
- Why use breadcrumb structured data for SEO?
- Google uses breadcrumb structured data to understand a page's position in the site hierarchy. Search results may display breadcrumb navigation instead of full URLs, which can improve click-through rates, enhance user experience, and help search engines better crawl site structure.
- What is the correct format for breadcrumb structured data?
- Must use BreadcrumbList type with itemListElement array containing at least two ListItems. Each ListItem requires position (integer starting from 1), name (breadcrumb label), and item (full absolute URL, except homepage which can omit the item field).
- How should breadcrumbs be ordered?
- Left to right (or homepage to current page): position 1 is homepage, position 2 is parent category, continuing to the current page. Example: Home > Blog > Tech Articles > Specific Article. The last item can be the current page URL or omitted.
- How to deploy breadcrumb structured data on a webpage?
- Place the generated JSON-LD code in the page's head or body section. Ensure it matches the visible breadcrumb navigation on the page. After deployment, validate using Google Rich Results Test or Schema Markup Validator.
- What are common errors in breadcrumb structured data?
- Common errors: missing required fields (position, name), using relative URLs instead of absolute paths, itemListElement with fewer than two items, non-sequential position values, or mismatch between structured data and actual page navigation. These issues can cause Google to ignore or downweight the structured data.