# Set up product siblings

{% hint style="danger" %}
**This guide applies to Aurora version 3.1.0 and newer**
{% endhint %}

The "Product siblings" feature allows for linking and displaying individual products as variants within one centralized product listing. Each product sibling has its own images, details, pricing, publishing controls, and descriptive URLs. This improves SEO and makes it easier for merchants to provide a higher-converting customer experience.

#### Setting up product siblings consists of 6 major steps

1. [preparing a product base](/aurora-theme/tutorials/set-up-product-siblings/step-1-prepare-product-base.md)
2. [creating a metaobject with a product list](/aurora-theme/tutorials/set-up-product-siblings/step-2-create-a-metaobject.md)
3. [adding lists of sibling products as metaobject entries](/aurora-theme/tutorials/set-up-product-siblings/step-3-add-metaobject-entries.md)
4. [creating 2 product metafields: for the product list and the option value](/aurora-theme/tutorials/set-up-product-siblings/step-4-create-product-metafields.md)
5. [adding values to the 2 metafields](/aurora-theme/tutorials/set-up-product-siblings/step-5-add-values-to-metafields.md)
6. [adding the “Product siblings” block to the theme](/aurora-theme/tutorials/set-up-product-siblings/step-6-add-block-to-theme.md)

{% hint style="info" %}
In this tutorial, we link product siblings based on the **Color** option. As a result, individual products will appear on one centralized product page as color variants.
{% endhint %}

{% hint style="warning" %}
**IMPORTANT:**<br>

* Product siblings appear as variants of one product **only on the product page**. In collections, they show as separate product cards.
* **You can't show siblings in one product card**. Please, use the  [standard Shopify variants](https://help.shopify.com/en/manual/products/variants/add-variants).
* **When you switch sibling variants on the product page, all other product options reset to default values.** Example: your siblings are linked by a color option but also have their own size options, where "S" is the default size. Even if you select size "L" first, changing the color option resets the size back to "S".
  {% endhint %}

#### Video Guide

Watch the video to see the whole process of setting up product siblings:

{% embed url="<https://www.youtube.com/watch?v=KlERijQOLLo>" %}
Video guide on setting up product siblings in the Aurora theme
{% endembed %}


---

# 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://getsitecontrol.gitbook.io/aurora-theme/tutorials/set-up-product-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.