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

---

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

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

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.

---

Need help?

Whether you have a question, run into an issue, or just need some guidance, our support team is here to help.

Chat with us Submit a ticket