---
title: "Breadcrumb Schema · Unhead"
meta:
  "og:description": "Use defineBreadcrumb() to add BreadcrumbList structured data. Display clickable navigation paths in Google search results for better user experience."
  "og:title": "Breadcrumb Schema · Unhead"
  description: "Use defineBreadcrumb() to add BreadcrumbList structured data. Display clickable navigation paths in Google search results for better user experience."
---

**Schema**

# **Breadcrumb Schema**

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/breadcrumb.md)

Last updated **Jan 19, 2026** by [Harlan Wilton](https://github.com/harlan-zw) in [docs: sync](https://github.com/unjs/unhead/commit/d2f86454774aa60706628b46a850653e1e4d56d9).

**On this page **

- [Schema.org Breadcrumb](#schemaorg-breadcrumb)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Examples](#examples)
- [Defaults](#defaults)
- [Relation Transforms](#relation-transforms)
- [Resolves](#resolves)
- [Types](#types)
- [Related Schemas](#related-schemas)

## [Schema.org Breadcrumb](#schemaorg-breadcrumb)

- **Type**: `defineBreadcrumb(input?: Breadcrumb)`Describes an `Breadcrumb` on a `WebPage`.

## [Useful Links](#useful-links)

- [**BreadcrumbList - Schema.org**](https://schema.org/BreadcrumbList)
- [**Breadcrumb Schema Markup - Google Search Central**](https://developers.google.com/search/docs/advanced/structured-data/breadcrumb)
- [**Breadcrumb - Yoast**](https://developer.yoast.com/features/schema/pieces/breadcrumb)
- [**Recipe: Breadcrumbs**](https://unhead.unjs.io/docs/schema-org/guides/recipes/breadcrumbs)

## [Required properties](#required-properties)

- **itemListElement**An array of `ListItem` objects, representing the position of the current page in the site hierarchy.

## [Examples](#examples)

### [Minimal](#minimal)

```
defineBreadcrumb({
  itemListElement: [
    { name: 'Home', item: '/' },
    { name: 'Blog', item: '/blog' },
    { name: 'My Article' },
  ],
})
```

## [Defaults](#defaults)

- **@type**: `BreadcrumbList`
- **@id**: `${canonicalUrl}#breadcrumb`

## [Relation Transforms](#relation-transforms)

[**WebPage**](https://unhead.unjs.io/docs/schema-org/api/schema/webpage)

- sets default `breadcrumb` to this node

## [Resolves](#resolves)

- `itemListElement.position` is computed for each list element

## [Types](#types)

```
/**
 * A BreadcrumbList is an ItemList consisting of a chain of linked Web pages,
 * typically described using at least their URL and their name, and typically ending with the current page.
 */
export interface BreadcrumbSimple extends ItemList {}
```

## [Related Schemas](#related-schemas)

- [**ItemList**](https://unhead.unjs.io/docs/schema-org/api/schema/item-list) - List structure
- [**Article**](https://unhead.unjs.io/docs/schema-org/api/schema/article) - Article navigation
- [**Product**](https://unhead.unjs.io/docs/schema-org/api/schema/product) - Product navigation

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/breadcrumb.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/breadcrumb.md)

**Did this page help you? **

[**Book Schema** Use defineBook() to add Book structured data. Enable rich results with book editions, ISBN, author, and purchase actions in Google search.](https://unhead.unjs.io/docs/schema-org/api/schema/book) [**Comment Schema** Use defineComment() to add Comment structured data. Connect user comments to articles and blog posts with author and date information.](https://unhead.unjs.io/docs/schema-org/api/schema/comment)

**On this page **

- [Schema.org Breadcrumb](#schemaorg-breadcrumb)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Examples](#examples)
- [Defaults](#defaults)
- [Relation Transforms](#relation-transforms)
- [Resolves](#resolves)
- [Types](#types)
- [Related Schemas](#related-schemas)