From ac42d79df76a75b3c2b2bc797e624c99b4367d6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Krier?= <ced@b2ck.com>
Date: Sun, 9 Mar 2025 10:30:46 +0100
Subject: [PATCH] Document setup of Shopify variants

---
 modules/web_shop_shopify/doc/usage.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/modules/web_shop_shopify/doc/usage.rst b/modules/web_shop_shopify/doc/usage.rst
index afe2319ffe..97cfb8010c 100644
--- a/modules/web_shop_shopify/doc/usage.rst
+++ b/modules/web_shop_shopify/doc/usage.rst
@@ -47,3 +47,20 @@ You can also register a :abbr:`JSON (JavaScript Object Notation)` `webhook
 <https://shopify.dev/docs/apps/build/webhooks>`_ from the
 :guilabel:`Notifications` settings for each order event to get updates when
 they happen.
+
+.. _Setup Shopify Variants:
+
+Setup Shopify Variants
+======================
+
+To create variants of a product in Shopify, you need to set an `Attribute
+Set <product_attribute:model-product.attribute.set>` on the `Product Template
+<product:model-product.template>`.
+This *Attribute Set* must have at least one of the three :guilabel:`Shopify
+Options` selected with an `Attribute
+<product_attribute:model-product.attribute>`.
+
+.. note::
+
+   For each variant of a product, the value of the :guilabel:`Shopify Options`
+   attributes must be unique.