Linked Products

The Linked products block shows sibling products as image cards on the product page. Clicking a card opens that product while keeping the customer's supported Hat Lab selections.

What it does

• Shows related products as compact image cards inside Product details
• Highlights the current product so the selector feels like a native option picker
• Lets each linked product have its own short label
• Works with manual block setup or dynamic sources from product metafields

Recommended metafields

Create these product metafields in Shopify:

• custom.linked_products Type: Product, with a list of values
• custom.linked_products_label Type: Single line text
• custom.linked_product_label Type: Single line text

Recommended usage:

• custom.linked_products: the sibling products to show in the selector
• custom.linked_products_label: the heading shown above the cards, for example Choose style
• custom.linked_product_label: the short label shown on each linked-product card

Theme editor setup

1. Open your product template in the theme editor.
2. Inside Product details, add the Linked products block.
3. Use the dynamic-source button beside Linked products to select the Linked products product metafield (custom.linked_products).
4. Optionally use the dynamic-source button beside Heading to select Linked products label (custom.linked_products_label).
5. Adjust card width, spacing, radius, and label settings as needed.

You can also choose products manually in the block if you do not want to use metafields.

Fallback behavior

• If no linked products are configured, the block renders nothing.
• If the current product is not included in the linked-products list, it is injected at the start and shown as active.
• Duplicate linked products are ignored.
• If custom.linked_product_label is blank on a linked product, the product title is used instead.
• Customers choose a variant on the linked product rather than carrying over an unrelated variant from the previous product.

Recommended use case

This block works especially well when you sell multiple blanks that share the same design or customization flow. Customers can switch between those products from the product page without treating them like variants in the Shopify admin.