# Linked products

Linked products let customers move between related items (for example colors or styles) without leaving the product page. Slab uses the **Product sibling options** block for this.

## Steps

1. In Shopify admin, create a product metafield definition for **`custom.linked_collection`** (collection reference).
2. For each product that should show siblings, set that metafield to a collection that contains the related products.
3. Open **Online Store > Themes > Customize** and load a product template.
4. In the **Main product** section, add **Product sibling options** where you want the links to appear.
5. In the block settings, confirm **Product** matches the product you are editing (or pick one while testing).
6. Choose **Swatch selection**: **Buttons** for a small set of siblings, or **Dropdowns** when there are many.
7. Save the theme, then open a product that has **`custom.linked_collection`** set and confirm the options appear on the storefront.

## How it works

* The block reads related products from `product.metafields.custom.linked_collection`.
* Nothing renders on the storefront until that metafield points to a collection with products.
* In the theme editor, you may see a setup hint when the metafield is empty.

## Block settings reference

All options—swatches, labels, grid layout, spacing, colors, button size, and visibility—are documented on the [Product sibling options](https://help.brickspacelab.com/slab/content/blocks/products/sibling-options) block page.

## Troubleshooting

* Confirm each product has **`custom.linked_collection`** filled in.
* Confirm the linked collection contains the products you expect.
* Confirm the block is on the product template customers actually use.
* If the block never appears, check **Visibility** on the block (device limits can hide it).