🍞

Generate Breadcrumb Schema Markup Instantly (JSON-LD for SEO)

Generate JSON-LD BreadcrumbList schema markup for SEO. Add breadcrumb items with names and URLs to create structured data that helps search engines understand your site hierarchy.

Text_toolMarketing & SEO
Loading tool...

How to Use Breadcrumb Schema Generator

What is Breadcrumb Schema?

Breadcrumb schema is a structured data markup using JSON-LD format that tells search engines about your website's navigation hierarchy. It follows the Schema.org BreadcrumbList specification and helps Google and other search engines display breadcrumb trails in search results, making it easier for users to understand where a page fits within your site structure.

When properly implemented, breadcrumb schema can trigger rich snippets in Google search results, showing your site hierarchy directly in search listings and improving click-through rates.

How to Use This Tool

Step 1: Add Breadcrumb Items

Start by defining your breadcrumb trail from top to bottom:

Each breadcrumb item requires:

  • Name: The text label users see (e.g., "Home", "Electronics", "Laptops")
  • URL: The full URL to that page (must include https://)

Order matters:

  • Position 1 should be your homepage (usually "Home")
  • Position 2 is the first category or section
  • Position 3+ are subcategories or deeper pages
  • Last position is typically the current page

Best Practices for Names:

  • Keep names short and descriptive (2-5 words)
  • Use sentence case: "Web Development" not "WEB DEVELOPMENT"
  • Match the actual text on your breadcrumb navigation
  • Avoid generic terms like "Category" or "Page"

URL Format:

  • Always use absolute URLs: https://example.com/page
  • NOT relative URLs: /page (invalid)
  • Include protocol (https://)
  • Match the canonical URL of the page
  • Ensure URLs are accessible (not 404 or redirects)

Adding Items:

  • Click "Add Item" button to create new breadcrumb position
  • Fill in Name and URL for each item
  • Use trash icon to remove unwanted items
  • Minimum 1 item required (usually at least 2 for meaningful breadcrumbs)
  • Maximum 20 items allowed (though 3-6 is typical)

Step 2: Preview the Generated Schema

As you add or edit breadcrumb items, the tool automatically generates valid JSON-LD schema markup in real-time.

Schema Structure:

{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com" }, { "@type": "ListItem", "position": 2, "name": "Products", "item": "https://example.com/products" } ] }

What each field means:

  • @context: Defines Schema.org vocabulary
  • @type: Specifies BreadcrumbList type
  • itemListElement: Array of breadcrumb items
  • position: Numerical order (1 = first/top, 2 = second, etc.)
  • name: Display text for breadcrumb
  • item: URL of the page

Step 3: Copy or Download the Schema

Three options to save your schema:

Copy Button:

  • Copies raw JSON-LD to clipboard
  • Paste into your code editor
  • Use if manually adding to HTML

HTML Button:

  • Copies complete <script type="application/ld+json"> tag
  • Ready to paste directly into HTML
  • Includes opening and closing script tags

Download Button:

  • Downloads as breadcrumb-schema.json file
  • Useful for version control
  • Can be dynamically loaded if needed

Step 4: Add Schema to Your Website

Place the breadcrumb schema in your page's <head> section or at the end of <body>:

HTML Implementation:

<!DOCTYPE html> <html> <head> <title>Your Page Title</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [...] } </script> </head> <body> <!-- Your page content --> </body> </html>

WordPress:

  • Use a schema plugin (Schema Pro, Rank Math, Yoast SEO)
  • Or add to theme's header.php before </head>
  • Or use custom HTML block in page editor
  • Ensure only one breadcrumb schema per page

React/Next.js:

export default function ProductPage() { const breadcrumbSchema = { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [...] } return ( <> <Head> <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(breadcrumbSchema) }} /> </Head> {/* Page content */} </> ) }

PHP:

<?php $breadcrumb_schema = [ "@context" => "https://schema.org", "@type" => "BreadcrumbList", "itemListElement" => [...] ]; ?> <script type="application/ld+json"> <?php echo json_encode($breadcrumb_schema); ?> </script>

Important Implementation Notes:

  • Add schema to EVERY page that has breadcrumbs
  • Each page should have unique breadcrumb schema matching its position
  • Do not add the same schema to all pages (Google may ignore it)
  • The last item in breadcrumbs should be the current page

Step 5: Test Your Schema

Verify your breadcrumb schema is valid and properly implemented:

Google Rich Results Test:

  1. Enter your page URL or paste HTML code
  2. Click "Test URL" or "Test Code"
  3. Check for "BreadcrumbList" in detected structured data
  4. Fix any errors or warnings shown

Schema Markup Validator:

  1. Paste your schema JSON or enter page URL
  2. Verify no errors appear
  3. Check that all breadcrumb items are properly formatted

Google Search Console:

  1. Wait 1-7 days after implementation
  2. Go to Search Console → Enhancements → Breadcrumbs
  3. Check for any errors or warnings
  4. Monitor "Valid" breadcrumb markup count
  5. Request indexing for faster processing

Manual Browser Check:

  1. View page source in browser
  2. Find the <script type="application/ld+json"> tag
  3. Verify JSON is valid (no syntax errors)
  4. Check that breadcrumb URLs match your navigation

Step 6: Load Examples

Use pre-built examples to see common breadcrumb patterns:

E-commerce Product: Home → Electronics → Laptops → Gaming Laptops

  • Shows multi-level product categorization
  • Typical for online stores

Blog Article: Home → Blog → Technology → Article Title

  • Standard blog navigation hierarchy
  • Common for content websites

Service Page: Home → Services → Web Development

  • Simple 3-level hierarchy
  • Typical for business websites

Documentation: Home → Docs → API Reference → Authentication

  • Multi-level documentation structure
  • Common for developer documentation sites

Click any example to instantly load its breadcrumb structure, then customize the URLs and names to match your website.

Breadcrumb Schema Best Practices

Do's

Accurate Hierarchy:

  • Breadcrumbs must match actual site navigation
  • URLs should correspond to real clickable breadcrumb links
  • Do not invent fake hierarchy just for SEO

Consistency:

  • Use same breadcrumb structure across similar pages
  • Keep naming conventions consistent
  • Match breadcrumb schema to visible breadcrumb UI

Complete URLs:

  • Always use absolute URLs (https://example.com/page)
  • Include protocol (https://)
  • Ensure all URLs return 200 OK status
  • Do not use URLs with redirects or 404 errors

Mobile Optimization:

  • Breadcrumbs should be visible on mobile too
  • Schema works on mobile search results
  • Responsive breadcrumb UI improves UX

Don'ts

Avoid These Common Mistakes:

Do not use relative URLs:

"item": "/products" // WRONG "item": "https://example.com/products" // CORRECT

Do not skip hierarchy levels:

Home → Product // Missing category level Home → Category → Subcategory → Product // CORRECT

Do not use incorrect position numbers:

// WRONG - positions must start at 1 and increment "position": 0 "position": 1 "position": 3 // Skipped 2

Do not add breadcrumbs to homepage:

  • Homepage typically does not need breadcrumb schema
  • Breadcrumbs show navigation FROM homepage to deeper pages

Do not use breadcrumbs as keyword stuffing:

  • Keep breadcrumb names natural and user-friendly
  • Google may penalize manipulative schema

Do not duplicate breadcrumb schema:

  • Only one BreadcrumbList per page
  • Multiple instances may confuse search engines

Common Use Cases

E-commerce Product Pages

Typical Structure:

Home → [Main Category] → [Subcategory] → [Product] Home → Electronics → Laptops → Gaming Laptops Home → Clothing → Men → Shirts → Blue Oxford Shirt Home → Books → Fiction → Science Fiction → Dune

Tips:

  • Reflect your actual category hierarchy
  • Use category names users understand
  • Last breadcrumb is the current product

Blog Posts

Typical Structure:

Home → Blog → [Category] → [Article Title] Home → Blog → Technology → How to Build a Website Home → Resources → Tutorials → Beginner Guide to SEO

Tips:

  • Include "Blog" or content section name
  • Use primary category (if post has multiple categories)
  • Article title should match <h1> tag

Service/Business Pages

Typical Structure:

Home → Services → [Service Type] Home → Services → Web Development Home → About → Our Team → John Doe Home → Solutions → Enterprise → Cloud Hosting

Tips:

  • Keep hierarchy shallow (2-4 levels)
  • Use clear service/page names
  • Match website navigation structure

Documentation Sites

Typical Structure:

Home → Docs → [Section] → [Topic] Home → Documentation → API Reference → Authentication Home → Help Center → Getting Started → Installation Home → Guides → Advanced → Security Best Practices

Tips:

  • Show documentation organization clearly
  • Use section names from sidebar navigation
  • Help users understand doc structure

Troubleshooting

Schema Not Showing in Search Results?

Possible Causes:

  1. Not Indexed Yet

    • Wait 1-7 days for Google to crawl and process
    • Use Google Search Console to request indexing
    • Check "Coverage" report for indexing status
  2. Schema Validation Errors

    • Test with Google Rich Results Test
    • Check for JSON syntax errors
    • Verify all required fields are present
  3. Missing Visible Breadcrumbs

    • Google requires visible breadcrumb UI on page
    • Schema alone without visible breadcrumbs may be ignored
    • Implement both HTML breadcrumbs and schema
  4. URL Mismatches

    • Schema URLs must match actual navigation links
    • Verify URLs return 200 OK (not 404 or redirects)
    • Check that URLs are accessible to crawlers
  5. Google Chooses Not to Show

    • Rich results are not guaranteed
    • Google may decide other SERP features are more relevant
    • Desktop vs mobile results may differ

Common Schema Errors

Error: Missing required field "item"

// WRONG { "@type": "ListItem", "position": 1, "name": "Home" // Missing "item" field } // CORRECT { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com" }

Error: Invalid URL format

// WRONG "item": "/products" // Relative URL "item": "example.com" // Missing protocol // CORRECT "item": "https://example.com/products"

Error: Positions not sequential

// WRONG "position": 1 "position": 3 // Skipped 2 // CORRECT "position": 1 "position": 2 "position": 3

Breadcrumbs Not Appearing in Search Console?

  1. Check Enhancements Report:

    • Search Console → Enhancements → Breadcrumbs
    • May take several days to appear
    • Click "View report" for details
  2. Validate Schema:

    • Ensure schema is on indexed pages
    • Check robots.txt is not blocking pages
    • Verify schema is valid JSON-LD
  3. Request Inspection:

    • Use URL Inspection tool in Search Console
    • Check "Live Test" to see if Google can read schema
    • Look for any crawling errors

Frequently Asked Questions

Most Viewed Tools

🔐

TOTP Code Generator

2,997 views

Generate time-based one-time passwords from a TOTP secret key. Enter your base32 secret, choose a period and digit length, and get the current and next codes with a live countdown timer. Useful for testing and debugging 2FA integrations.

Use Tool →
{ }

JSON to Zod Schema Generator

2,982 views

Generate Zod validation schema code from a JSON sample object. Infers z.string(), z.number(), z.boolean(), z.array(), z.object(), and z.null() types automatically. Handles nested objects, arrays of objects with optional field detection, and outputs copy-ready TypeScript with import and z.infer type alias.

Use Tool →
{}

JSONL / NDJSON Formatter

2,912 views

Format, validate, and inspect JSON Lines (JSONL) and NDJSON files. Validates each line individually, reports parse errors by line number, outputs compact JSONL or a pretty-print preview, and lets you download the cleaned file.

Use Tool →
🔍

Secret and Credential Scanner

2,521 views

Scan pasted text, code, or config files for accidentally exposed API keys, tokens, passwords, and private keys. Detects 50+ secret types across AWS, GitHub, Stripe, OpenAI, and more — all client-side, nothing leaves your browser.

Use Tool →
🔐

TLS Cipher Suite Checker

2,486 views

Check TLS protocol version compatibility and cipher suite strength ratings against current best practices. Supports IANA and OpenSSL cipher names — rates each suite as Strong, Weak, or Deprecated and explains why.

Use Tool →
🔑

Password Entropy Calculator

2,484 views

Calculate the information-theoretic bit entropy of any password or API key. Detects character set pools automatically, shows the total number of possible combinations, and estimates crack time across five attack scenarios from rate-limited web logins to GPU cracking clusters.

Use Tool →

TOML Config Validator

2,247 views

Validate TOML configuration file syntax and report errors with line numbers. Paste any TOML content — Cargo.toml, pyproject.toml, config.toml — and instantly see a green checkmark with key counts and structure stats, or a precise error message pointing to the exact line. Includes a collapsible JSON structure preview to confirm what was parsed.

Use Tool →
🔒

Content Security Policy Generator

2,112 views

Build Content Security Policy headers interactively. Toggle directives like script-src, style-src, and img-src, select allowed source tokens, and add custom origins. Instantly outputs your CSP as an HTTP header, meta tag, Nginx directive, or Apache header.

Use Tool →

Related Marketing & SEO Tools

Share Your Feedback

Help us improve this tool by sharing your experience

We will only use this to follow up on your feedback