From 06f04ddbd096e4251680ed9434322330c01c06b1 Mon Sep 17 00:00:00 2001 From: Benjamin Willems Date: Tue, 1 May 2018 16:18:16 -0700 Subject: [PATCH] Add article about variants for end users --- guides/source/users/products/variants.html.md | 59 +++++++++++++++---- guides/users/products/variants.md | 39 ++++++++++++ 2 files changed, 86 insertions(+), 12 deletions(-) create mode 100644 guides/users/products/variants.md diff --git a/guides/source/users/products/variants.html.md b/guides/source/users/products/variants.html.md index fc5781cd6a3..c064efe411c 100644 --- a/guides/source/users/products/variants.html.md +++ b/guides/source/users/products/variants.html.md @@ -1,7 +1,18 @@ # Variants -A product can have many variants. For example, you may sell a t-shirt that comes -in two colors and three sizes. +A product can have many variants. Variants make it easy to sell multiple similar +items while only managing a single product listing. + +For example, you may sell a t-shirt that comes in two colors and three sizes. +Instead of managing six product listings, you can manage a single product with +six variants. + + + +Before you can create variants for a product, you need to create at least one +[option type and option value][option-types] for your store. + +[option-types]: option-types.html ## Variants are customer-selectable product options @@ -22,18 +33,42 @@ You can create [option types and option values][option-types] for any variant that you want to create. In addition to **Size** and **Color**, you may want to offer **Material**, **Quantity**, or other option types. -[option-types]: option-types.html +## Filter and search variants + +If you have products with many variants, you can filter the list of variants +by entering a partial **SKU** or the name of an **Option Value**. -## Change product details +For example, if you want to see all of the variants with the size `Small`, you +could use "small" as a search term. Or, if you have a range of SKUs, like +`ROR-125000` to `ROR-125099`, you could use "ror-1250" as a search term. -Variants can be more complex than this. While they use the [product -details][product-details] from the product they belong to, you can change the -following information about any variant: + -- **SKU** -- Dimensions (**Weight**, **Height**, **Width**, and **Depth**) -- **Price** -- **Cost Price** -- **Tax Category** +## Variant details + +A variant uses its product's [product details][product-details]. However, the +variant can also have its own details, which may different from the product's +values. The following variant details can optionally be added or overridden from +the product: + +- **SKU**: Assigns a separate SKU for each variant. +- Dimensions (**Weight**, **Height**, **Width**, and **Depth**): Assigns + distinct dimensions for the current variant. +- **Price**: Override the master price provided by the product details. +- **Cost Price**: Override the cost price provided by the product details. +- **Variant tax category**: Override the tax category provided by the product + details with any other tax category. [product-details]: product-details.html + +### Option types and values + +When you add or edit a variant, you can set which combination of [option +values][option-types] the variant represents. + +You can set the available option types in the product's [product +details][product-details]. + +Note that if you do not assign any option values to the variant, it may not +appear on the storefront and customers would never be able to buy the variant. + diff --git a/guides/users/products/variants.md b/guides/users/products/variants.md new file mode 100644 index 00000000000..c1a4d3fb9b3 --- /dev/null +++ b/guides/users/products/variants.md @@ -0,0 +1,39 @@ +# Variants + +A product can have many variants. For example, you may sell a t-shirt that comes +in two colors and three sizes. + +## Variants are customer-selectable product options + +The customer can choose any variant of a product from the storefront. + +In our t-shirt example, the product has six variants that customers can pick: + +| Variant | Color | Size | +|---------|----------|-----------| +| 1 | Red | Small | +| 2 | | Medium | +| 3 | | Large | +| 4 | Green | Small | +| 5 | | Medium | +| 6 | | Large | + +You can create [option types and option values][option-types] for any variant +that you want to create. In addition to **Size** and **Color**, you may want to +offer **Material**, **Quantity**, or other option types. + +[option-types]: option-types.md + +## Change product details + +Variants can be more complex than this. While they use the [product +details][product-details] from the product they belong to, you can change the +following information about any variant: + +- **SKU** +- Dimensions (**Weight**, **Height**, **Width**, and **Depth**) +- **Price** +- **Cost Price** +- **Tax Category** + +[product-details]: product-details.md