---
title: "Breadcrumb Schema"
description: "Use defineBreadcrumb() to add BreadcrumbList structured data. Display clickable navigation paths in Google search results for better user experience."
canonical_url: "https://unhead.unjs.io/docs/schema-org/api/schema/breadcrumb"
last_updated: "2026-05-16T21:55:14.394Z"
---

## Schema.org Breadcrumb

- **Type**: `defineBreadcrumb(input?: Breadcrumb)`<br />

Describes an `Breadcrumb` on a `WebPage`.

## 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](/docs/schema-org/guides/recipes/breadcrumbs)

## Required properties

- **itemListElement**<br />

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

## Examples

### Minimal

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

## Defaults

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

## Relation Transforms

[WebPage](/docs/schema-org/api/schema/webpage)

- sets default `breadcrumb` to this node

## Resolves

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

## Types

```ts
/**
 * 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

- [ItemList](/docs/schema-org/api/schema/item-list) - List structure
- [Article](/docs/schema-org/api/schema/article) - Article navigation
- [Product](/docs/schema-org/api/schema/product) - Product navigation