AEOTools

Breadcrumb Schema Example: How to Add BreadcrumbList JSON-LD

Updated July 10, 2026 by vito.wu

BreadcrumbList schema explains how a page fits into your site hierarchy. It works best when the JSON-LD matches a visible breadcrumb trail, uses canonical URLs, and gives both users and search engines a clear path from the homepage to the current page.

Generate BreadcrumbList markup for your page

Add the page path, preview the ordered JSON-LD, and copy markup that matches your site hierarchy.

Open Breadcrumb Schema Generator

What Does BreadcrumbList Schema Do?

BreadcrumbList schema gives search engines an ordered map of a page location within a website. It is especially useful on editorial sites, ecommerce categories, documentation, directories, and any site with more than one navigation level.

It is not a substitute for navigation. Build a useful visible path first, then describe that same path with structured data. This keeps the page understandable when search engines evaluate both the HTML and the JSON-LD.

Visible path

Home > Blog > Technical SEO > How to Add Breadcrumb Schema

Blog Post Breadcrumb Schema Example

Use this pattern for articles that live inside a stable editorial category. Every breadcrumb item should match navigation that visitors can see on the page.

BreadcrumbList JSON-LD
{
  "@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": "Technical SEO",
      "item": "https://example.com/blog/technical-seo"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "How to Add Breadcrumb Schema",
      "item": "https://example.com/blog/technical-seo/breadcrumb-schema"
    }
  ]
}

Visible path

Home > Electronics > Headphones > Wireless Headphones

Ecommerce Category Breadcrumb Schema Example

Use this pattern for a category or product page. Keep the path aligned with the category navigation users use to reach the page.

BreadcrumbList JSON-LD
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://example.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Electronics",
      "item": "https://example.com/electronics"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Headphones",
      "item": "https://example.com/electronics/headphones"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Wireless Headphones",
      "item": "https://example.com/electronics/headphones/wireless"
    }
  ]
}

Visible path

Home > Docs > API Reference > Authentication

Documentation Breadcrumb Schema Example

Use this pattern for help centers, developer documentation, and knowledge bases where the page hierarchy is useful for both users and crawlers.

BreadcrumbList JSON-LD
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://example.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Docs",
      "item": "https://example.com/docs"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "API Reference",
      "item": "https://example.com/docs/api"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Authentication",
      "item": "https://example.com/docs/api/authentication"
    }
  ]
}

Breadcrumb Schema Rules

  1. Show the same breadcrumb path to visitors on the page. Do not add categories that users cannot see or follow.
  2. Use positions starting at 1 and keep them in the same order as the visible path.
  3. Use the canonical URL for each breadcrumb item, including the current page when it appears as the final item.
  4. Use descriptive labels such as Product Guides or API Reference instead of generic labels such as Section.
  5. Only add BreadcrumbList schema to pages that genuinely sit inside a useful hierarchy.

Related Schema Resources

Breadcrumb Schema GeneratorSchema Markup ExamplesFull Schema Markup GeneratorArticle Schema GeneratorProduct Schema GeneratorAEO Checker

Breadcrumb Schema FAQ

What is BreadcrumbList schema?

BreadcrumbList schema is JSON-LD structured data that describes the ordered path from the homepage to the current page. Each list item includes a position, a visible name, and a URL.

Should breadcrumb schema match visible breadcrumbs?

Yes. Breadcrumb schema should match the navigation users can see on the page. The names, order, and destination URLs should describe a real path through the site.

Should I include the current page in BreadcrumbList schema?

Usually, yes. Including the current page as the final item makes the path complete. Use the current page canonical URL and a label that matches the page title or visible breadcrumb label.

Can a page have more than one breadcrumb path?

Use one primary path that best represents how users navigate to the page. Multiple competing paths can make the page hierarchy harder to understand, especially when they do not match visible navigation.

Does BreadcrumbList schema guarantee breadcrumb rich results?

No. Valid BreadcrumbList schema helps search engines understand hierarchy, but Google decides whether and how to display breadcrumbs in search results.

Ready to build your breadcrumb path?

Enter the real page hierarchy, copy the JSON-LD, and keep the visible navigation and structured data in sync.

Generate Breadcrumb Schema