# Siblings Setup - Troubleshooting Checklist

### Metafields Setup

Ensure the metafields use the mandatory **namespace and key** we’ve shown in the setup:

* <mark style="color:$warning;">theme.siblings</mark> - mandatory - links sibling products
* <mark style="color:$warning;">theme.sibling\_color</mark> - required to display correct color within the swatch, otherwise the sibling swatches default to gray

***

⚠ Any metafield **namespace and key** different from <mark style="color:$warning;">theme.siblings</mark> or <mark style="color:$warning;">theme.sibling\_color</mark> will **not** work.&#x20;

The namespace and key is greyed out at first so you will need to click on it in order to be able to edit it:

<figure><img src="/files/pzZKlyrwYIrNECPNNtwX" alt=""><figcaption></figcaption></figure>

***

<figure><img src="/files/JxzqndRNS54YTOJsguD3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/HLK8bECT1DOx5dmhVt2e" alt=""><figcaption></figcaption></figure>

***

### Product Status

\- All sibling products must be **active**, make sure they are **not** set to draft.\
\- All sibling products must be **published** on the **Online Store** sales channel.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfTHWfkP1Dycb6pNQAVgPWu6BNmteD14QAQRxRyli5uVy30wp8vU5lmZug-BjlKHAKMDRX8VFSjTe-98pJQ8gkTMCi_iVQuTXt8zzqZNJ5PuofU5-GO3fthF64uEczPMsISyF-YDw?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

***

### Siblings Block Assignment

\- **The siblings metafields** must be connected to the **siblings block** in the product template.\
\- If you have multiple product templates, then ensure that **each template** has the siblings block and correct metafields applied, as custom templates have their own individual setup.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGapS5W_Vr4PWVRz48A6xaAGcZGkm2B2oxslvtVaQbzMH7OabiRjcGe3G-00fDTB_Oo3SRkc5q2aUdHZ-W4bwtwFZBmNC4y0rXTtInXMICapg8pGo7SJ3ZBmB_JCExLHHnIqAkEQ?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

***

### Correct Collection Handle

\- Each sibling product must have the **same collection handle** applied in its <mark style="color:$warning;">theme.siblings</mark> metafield.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc2GsiSonWeg5ExrWOlDkJQS7s6ndoWJZASJPLmJWydooFGxYkkBFx1aUTDIIC0NYMrrgqkg6sUxMU4UxThCMLoB5aW7z0fcE10tknI2SzdSGXWn3CZs1J1DeM57-YUu_4Ls_6BYQ?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcfY_pJqiHb9flUoED2XETmjDm5grNe2xnz9oBENeW5iywrKqvhWQvnSSxxXRnLoMdCn4xG10KeJozeWz9oNApJ3WPFuGP3-3YClpuwiRPqQVqCZfwPfZNxcx6LGRf7ZPMmP1CJCQ?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

***

### Color Display

\- If color swatches default to a gray color, then ensure <mark style="color:$warning;">theme.sibling\_color</mark> is filled for **every** sibling product with your custom color.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdlUZ09mrAQKbQ4WBhKYWLMPmou6uaLxvMatFLYW1L89mwQYCSgUWeJWyMJfDLTtmkGHpWWxSLoup7Lxqt-U-rwnxfTr8DNt9NqJIQP8hb6POpa9UYyK8FWcoQDfnA9WTerbTqADA?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

***

### Collection Status

\- The collection containing your sibling products must be **published** on the **Online Store** sales channel.\
Without this, the theme cannot find the data and siblings will not display.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXemKx3phPC0qohFweXiSEBVHtMukrklcUYOJkU4bYgGPf0Fmosdnf33J426NwQH7repwlUeVZE_lkdBB7JWGg4fG05nV4Ga5aIHPvSOoWJ1RuGu7fbtDQnk21XeMoj5PQz3H73jyQ?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

***

### Storefront API Access

\- Ensure the metafield has "**Storefront API access**" enabled, otherwise the metafield data cannot be read. This option can be found on the page where you create your metafield, or if you have already created it, click on the metafield and scroll to the very bottom.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcFryT523Kg9YgfPXDvyMy28oGjYULazJTJSLOOLStY6QzwAhJsaAuYp0dXn7ewR2VcQtPEMwG_8JHwMPo7mOtsvZd8Y13LI9OuBcuzZ6Cm52Y7M7kvvstXtrbcawYbkPf1SgH5?key=gistFwr7Gx_ipdU0hDt-Rw" alt=""><figcaption></figcaption></figure>

<br>


---

# 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://broadcast.presidiocreative.com/siblings/product-siblings/siblings-setup-troubleshooting-checklist.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.