> For the complete documentation index, see [llms.txt](https://story.groupthought.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://story.groupthought.com/siblings/product-siblings/siblings-block-setup.md).

# Siblings block setup

> Feature introduced in Story 3.2.0

The last step in configuring Product Siblings is to add the Siblings block to your Product detail page and connect the metafields created in the earlier steps.

### Add Siblings block and position block

In the Theme Editor, navigate to a product page to configure the default product template (Product detail page). If you're using a different product template, change to that template. 

1. Under **Product page** in the sections column, choose **Add block** to add the **Siblings** block. 
2. Move the **Siblings** block **above** the **Form** block:

Under **Product page** in the sections column, choose **Add block** to add the **Siblings** block. 

![](/files/QxgcXHIEO7Z3x0QPh7f1)

{% hint style="success" %}
When you move the **Siblings** block above the **Form** block, it will line-up nicely below the product title and price and just above any other variant options like size. 
{% endhint %}

### Product siblings collection handle

Under the Block options, click on the dynamic source icon for **Product siblings collection handle** and map to the **Siblings collection** metafield:

![](/files/aVV4XZ8ZvDma0ElAntTI)

This is will add the **Siblings** collection metafield:

![](/files/FQCSTR4QUAgUKeKva7gx)

### Product color metafield

Next, add the **Cutline** metafield to the **Product color metafield** by using the Insert dynamic source icon:

![](/files/3Fox9uhURx6jHljoJs2e)

This is will add the **Cutline** collection metafield: 

![](/files/2UsLRSSI47BN0SaJcxzy)

Once both metafields have been added, you've completed all the steps required to setup Product Siblings 👏

![](/files/06C2vDJEGqjrrol6WxxQ)

### Check the results

Save the changes and now you can test by viewing one of the products to ensure the Siblings feature is working:

![](/files/ATZWfhofNQ29U8XZ5Jl7)

Verify that the image swatches are created and test each one to view the each variant option. 

{% hint style="success" %}
Remember to move the **Siblings** block up **above** the **Form** block in order for the swatches to appear above your other variant options. 
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://story.groupthought.com/siblings/product-siblings/siblings-block-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.