Agent Wranglers

SEO-17Recommended

Show where the page sits

Show a breadcrumb trail on inner pages, with the current page not linked. Mark it up as a matching BreadcrumbList.

By Agent Wranglers. Updated .

How to do it

Render the trail as a nav with an ordered list. Show the current page as plain text with aria-current="page". Use the same names and URLs in the BreadcrumbList. The last item may leave out item. Add the rest of the page's markup as Describe each page for machines says.

Examples

HTML example

<nav aria-label="Breadcrumb">
  <ol>
    <li><a href="/">Home</a></li>
    <li><a href="/services">Services</a></li>
    <li aria-current="page">Website review</li>
  </ol>
</nav>

JSON example

{
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
    { "@type": "ListItem", "position": 2, "name": "Services", "item": "https://example.com/services" },
    { "@type": "ListItem", "position": 3, "name": "Website review" }
  ]
}

How to check

A test reads the visible trail and the JSON-LD on every inner page. The names and URLs match in the same order.

Sources

For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/seo/site-structure/breadcrumbs">Agent Wranglers SEO playbook</a>. In code you write, add a comment next to it with the same link.