> 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-set-up-product-links.md).

# How to set up product links

The **Product link** block adds a button on the product page that links to a related product — usually another colour or style that exists as a separate listing. Add one block per linked product to build a row of buttons.

![A row of product link buttons on the product page](/files/WfArmG36bQxo8l4ghXZc)

***

## Step 1 — Create the metafield definition

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

* **Name** — `Men product`
* **Namespace and key** — `custom.men_product` (or any name you prefer)
* **Type** — Product, one value

Click **Save**.

![Creating the Linked product metafield definition](/files/yIdo1r5zKdwnl5PYkRZx)

{% hint style="info" %}
Each **Product link** block shows one button to one product, so create **one metafield per link** you want in the row. For a men's / women's / kids' set, for example, define `custom.men_product`, `custom.women_product`, and `custom.kid_product`.
{% endhint %}

***

## Step 2 — Assign the linked product on each product

Open a product, scroll to **Metafields → Linked product**, and select the related product (for example, another colour of the same style). Save, and repeat for every product in the group.

![Assigning the linked product on a product's metafield](/files/cQns4C9DqPSyPNjtQxL4)

***

## Step 3 — Add the Product link block and connect it

In the theme editor, go to the product page → **Product Information** section → **Details** block, and add a **Product siblings** block. Inside it, add one **Product link** block per link you want, and connect each block's **Product** field to its metafield: click the **Connect dynamic source** icon, pick the metafield, and save.

{% tabs %}
{% tab title="First link" %}
![Connecting the Women product metafield to a Product link block](/files/bAyePOTsa0vQgd6HUByO)
{% endtab %}

{% tab title="Second link" %}
![Connecting the Men product metafield to a Product link block](/files/JHgpwdz6Oj7A2D59YpDu)
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Product link** blocks live inside a **Product siblings** block — they can't be added directly to **Details**. For a row of buttons, add several **Product link** blocks, each connected to its own metafield. The button whose linked product matches the product being viewed is highlighted automatically.
{% endhint %}

{% hint style="info" %}
Prefer not to use a metafield? In each **Product link** block, set the **Product** field to the target product by hand — the rest of the flow is the same.
{% endhint %}