# Siblings

The **Siblings** block is designed to display **product color variations** as **separate products**, enabling merchants to offer a clean, navigable experience where each color is its own product. This is especially useful for stores that manage color options via unique product listings rather than variants.

> Only one Siblings block is allowed per section (`limit: 1`).
>
> [Learn more about product siblings](https://broadcast.invisiblethemes.com/siblings/product-siblings/about-product-siblings)

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2Fo9NMvrx0WK5PQUe2petV%2FUntitled%20image%20(33).png?alt=media&#x26;token=523c3de7-3baa-4865-9217-f4dacb473de4" alt="Image depicting the siblings block of the product pages section"><figcaption></figcaption></figure>

<table><thead><tr><th width="208.36114501953125">Settings</th><th width="114.564208984375" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Product siblings collection handle</td><td align="center"><code>metafield</code></td><td>Set this to a collection handle via metafield that contains all sibling products. This collection must include all siblings.</td></tr><tr><td>Product color metafield</td><td align="center"><code>metafield</code></td><td>Specify the metafield namespace and key for the product color (e.g. <code>theme.sibling_color</code>). This enables matching and labeling sibling products.</td></tr><tr><td><strong>Typography</strong></td><td align="center"></td><td></td></tr><tr><td>Option size</td><td align="center"><code>select</code></td><td> Choose from <code>Extra small</code>, <code>Small</code>, <code>Medium</code>, <code>Large</code>, or <code>Extra large</code>.</td></tr><tr><td>Value size</td><td align="center"><code>select</code></td><td> Choose from <code>Extra small</code>, <code>Small</code>, <code>Medium</code>, <code>Large</code>, or <code>Extra large</code>.</td></tr><tr><td><strong>Padding</strong></td><td align="center"></td><td></td></tr><tr><td>Bottom</td><td align="center"><code>range</code></td><td>Controls the space below the block.</td></tr></tbody></table>

## Notes

* The [siblings](https://broadcast.presidiocreative.com/siblings/product-siblings) feature depends on **two metafields**:
  * A **collection metafield** to define the group of related products.
  * A **color metafield** to match and display color variants.
* Useful for brands that want **individual URLs and SEO optimization** per color while still linking the experience together visually.


---

# 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/product-theme-blocks/siblings.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.
