Skip to main content

Linked Products

The Linked products block lets you show sibling products on the product page as option-like image cards. Clicking a card sends the customer to that product page while preserving supported customization context like hatlab, hatlab_tag, and view.

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

Create these product metafields in Shopify:

  • custom.linked_products Type: Product list (list.product_reference)
  • 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. Connect Linked products to product.metafields.custom.linked_products.
  4. Optionally connect Heading to product.metafields.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.
  • variant is intentionally not preserved in linked-product URLs so customers do not land on stale variant selections.

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.