Siblings Setup - Troubleshooting Checklist

Metafields Setup

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

• theme.siblings - mandatory - links sibling products

• theme.siblings_color - required to display correct color within the swatch, otherwise the sibling swatches default to gray

---

⚠ Any metafield namespace and key different from theme.siblings or theme.siblings_color will not work.

---

---

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.

---

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.

---

Correct Collection Handle

- Each sibling product must have the same collection handle applied in its theme.siblings metafield.

---

Color Display

- If color swatches default to a gray color, then ensure theme.siblings_color is filled for every sibling product with your custom color.

---

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.

---

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.