> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/how-to-guides/how-to-custom-the-breadcrumb-collection.md).

# How to custom the breadcrumb collection

Helix builds the breadcrumb trail automatically from the current page. On product pages, the collection shown comes from the URL — a visitor on `/collections/men/products/example` sees **Men**. On a plain `/products/example` URL (no collection), Helix falls back to the first collection the product belongs to.

To always show a specific collection regardless of how the visitor arrived, pin it with a metafield.

![The breadcrumb trail on a product page](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-ceab3d01bb72b30c08a69c6bc53a0d2b6c99e9e8%2Fhow-to-breadcrumb-collection-overview.png?alt=media)

***

## How to Use a Metafield to Override the Breadcrumb Collection

**Step 1 — Create the metafield definition**

In Shopify admin, go to **Settings → Metafields and metaobjects → Products**, click **Add definition**, and set:

* **Name** — `Breadcrumb collection`
* **Namespace and key** — `custom.breadcrumb_collection`
* **Type** — Collection, one value

Click **Save**.

![Creating the Breadcrumb collection metafield definition](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-9a1a85f6f03212c71298fee3edcd4a9965428218%2Fhow-to-breadcrumb-collection-metafield.png?alt=media)

**Step 2 — Assign the collection to products**

Open a product in Shopify admin, scroll to **Metafields → Breadcrumb collection**, select the collection you want in the breadcrumb, and save. Repeat for every product that needs a pinned collection.

![Assigning the breadcrumb collection on a product's metafield](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-9434c6a1739a1a700ce4b596750bfa8da5d1995d%2Fhow-to-breadcrumb-collection-assign.png?alt=media)

{% hint style="info" %}
When `custom.breadcrumb_collection` is set, Helix uses that collection on all product page URLs — including plain `/products/handle` URLs with no collection context. Products without the metafield fall back to the collection in the URL, or to the first collection the product belongs to.
{% endhint %}
