← Brand Metadata

Reference

Building a breadcrumb

How a URL turns into BreadcrumbList schema, one part at a time.

1. Start with the URL

https://goire.grounded.singles/articles

The domain becomes the Home crumb. Each path segment after it becomes one more crumb. (The https:// scheme is just kept on the links, it is not a crumb.)

2. Each part becomes a crumb

goire.grounded.singlesthe domain
↓
Home
position 1
links to https://goire.grounded.singles/

The domain always maps to Home (the site root, with a trailing slash).

/articlespath segment 1
↓
Articles
position 2
links to https://goire.grounded.singles/articles

The slug articles is tidied into a readable name, and the link is the URL up to and including this segment.

3. The schema it produces

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://goire.grounded.singles/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Articles",
      "item": "https://goire.grounded.singles/articles"
    }
  ]
}
@type Declares the whole block as a breadcrumb trail (BreadcrumbList), and each entry as one crumb (ListItem). itemListElement The ordered array of crumbs. position The order of the crumb, starting at 1 on the left. name The readable label shown in the trail. item The absolute URL the crumb links to. The current (last) page may omit this.

The rule, in one line

Home (the domain) is position 1. Then add one crumb per path segment: bump the position, set name to the tidied segment, and set item to the URL up to and including that segment. The last crumb is the current page.

Going one level deeper

Add the article's own slug, https://goire.grounded.singles/articles/the-logic-of-local, and you simply get a third crumb. Nothing else changes:

https://goire.grounded.singles/articles/the-logic-of-local

Home › Articles › The Logic of Local