# Linked products block

### Overview <a href="#h_cca672d346" id="h_cca672d346"></a>

If you have multiple versions of one product split into different product listing it may be hard for customers to find the option they want. Using the "Linked products" block you can display additional products as options on your product page.

How it works:

* The block shows all products from the collection assigned to the metafield
* All linked products must be in the same collection
* If the block is empty, the metafield isn’t set or the collection is empty

> Note: You can’t link individual products directly; you must use a collection as the intermediary.

***

### Enable the product block <a href="#h_85cfff255d" id="h_85cfff255d"></a>

1. Go to Online Store > Themes > Customize
2. Navigate to the product template then click "Add block" within the "Product" section
3. Move the block and add a label
   * It's usually best to display the "Linked products" block above the "Buy buttons"
   * Try adding a label that describes the additional linked products. If the additional products are variants of different color you could update the label to "Color".
4. Hit **Save**

***

### Create metafield definition <a href="#h_4a7f6a8b39" id="h_4a7f6a8b39"></a>

1. Navigate to **Settings** > **Custom data** > **Products**
2. Click **Add definition**
3. In the name field type "Linked collection"
4. Ensure the namespace and key field is `custom.linked_collection`
5. Set the data type as "Collection"
6. Hit **Save**

***

### Update metafield <a href="#h_dd4b183e2a" id="h_dd4b183e2a"></a>

1. Navigate to the product you'd like to update
2. Scroll to the bottom and select a collection for the metafield
3. Click **Save**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.brickspacelab.com/keystone/guides/products/product-linked-products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.