# Variants and options

> Turn one product into several buyable versions, such as sizes or pack sizes, each with its own price and stock.

Source: https://docs.personacart.com/commerce/product-variants

In short: {"Turn one product into several buyable versions, such as sizes or pack sizes, each with its own price and stock."}

- Options turn one product into several buyable versions: a shirt in Small, Medium and Large, a coaching product in "5 sessions" and "10 sessions", a membership for "Grades 4 to 8" and "Grades 8 to 12".
- You list the options, PersonaCart makes every combination (each one is a **variant**), and you set price, stock and photos per variant.

Video: How to Add Sizes and Variants to a Product (https://www.youtube.com/watch?v=TK3YnUw-Wys)

1. Open a product and go to **Product Data → Options** (or **Packages**).
2. Add an option and its values. PersonaCart makes every combination.
3. Set price and stock in the table, then **Save Product**.

## Where to find it

Sidebar → COMMERCE → Products → open a product → **Product Data**. The section is called:

- **Options** on a physical product, a membership and a subscription box.
- **Packages** on a training or coaching program, a Book a slot product and a session pack.

Digital downloads, courses, events, bundles and tips cannot have options. If you try, the editor says "This product type can't have options."

## Add an option

1. Press **Add option**. The dialog says: define an option name and its possible values, and variants are generated from every combination.
2. **Option name**, for example Color, Size, Material or Grade.
3. **Option values.** Type a value and press Enter or comma to add each one.
4. The dialog counts the result: "6 variant combinations will be generated." A product can have up to 200 variants. Over that, the dialog asks you to remove some values.
5. Press **Add option** again to save. Use **Add another option** for a second option such as Size plus Color.

You can rename an option, remove it, or remove a single value at any time. **Drag the handle** to reorder options and values: the top option is the one shown first on your shop.

### How buyers will see it

- Below the options a preview shows what buyers see.
- Tap a value to make it the **default** buyers see first (it carries a "default" tag).
- An option called **Color** also lets you give each value a swatch colour; choose it with the colour dot next to the value, and clear it with the small x.
- You can also attach a photo to an option value, so a buyer who picks "Black" sees the black version.

## The variant table

Once options exist, a **Variants** table lists every combination with a count. Columns:

| Column | What it does |
|---|---|
| **Images** | The photos shown first when this variant is selected. Click to **Edit images** and **Choose images**. The first image is marked "1st". |
| **Name buyers see for this option** | The name buyers see for this variant instead of the product's own name. Leave it blank to keep showing the product's name. |
| **SKU** | Your own code for this variant. A duplicate shows "Duplicate SKU ... give this variant its own." |
| **Price** | Leave it empty to inherit the product price (the table shows the base price). Prices that differ from the rest are tinted, with a note "N prices differ from the rest. Check the tinted rows." |
| **Stock** | Only on physical products and subscription boxes. Empty stock counts as 0. |
| **Seats** | Training / coaching programs only. How many spots are left for this class. Leave blank for unlimited; **0** shows **Sold out** and buyers cannot book it. Each booking takes one spot. |
| **Duration (min)** | Book a slot only. How long each session in this package runs; buyers see it when choosing the package. |
| **Sessions** | Book a slot and session pack. How many sessions this package grants, for example 8 for an "8-Session Pack". Every package needs this number. |
| **Link path** | The shareable address for this exact variant. Leave it as the auto-generated path, or type your own short one such as `train/josh`. Clearing it goes back to auto. There is a copy-link button per row. |
| **Actions** | **Edit variant** and **Delete variant**. |

**Set all prices** (above the table) applies one price to every variant in one step ("Apply to N"); you then **Save** the product to keep it.

### Edit variant

The pencil opens **Edit variant**, headed by the combination (for example "Black / Large"):

- **Name buyers see for this option** and **Variant images**: what this version is called and looks like. Images are "shown first on the storefront when this variant is selected".
- **SKU** and **Barcode**.
- **Price** ("Leave empty to use product price") and **Compare-at price**.
- **Seats** (training / coaching programs only) and **Stock quantity** (physical products and subscription boxes only).
- **Weight**, in the product's weight unit. It defaults to the product's weight.
- **Size / measurement guide**: **Inherit product guide**, **No guide**, or one of your saved guides. See [Physical products](/commerce/product-type-physical).

## What each type uses

| Type | Options | Per-variant stock | Notes |
|---|---|---|---|
| Physical product | Yes (Options) | Yes | Also size guide, weight and barcode per variant. |
| Subscription box | Yes (Options) | Yes | |
| Membership | Yes (Options) | No | One membership with a "Grade" style axis, each row with its own price and photo. Members of either grade are members of the same membership. |
| Training / coaching program | Yes (Packages) | No | Seats per variant, for class days. |
| Book a slot / facility booking | Yes (Packages) | No | Duration and sessions per package. |
| Session pack | Yes (Packages) | No | Sessions per package. |
| Digital, course, event, bundle, tip | No | n/a | |

:::note[Check the table before you save]
- **A product whose variants all have 0 stock cannot be published.** The Ready to publish card tells you to set the stock.
- **Variants without a price inherit the product price.** Change the base price and they follow.
- **Session packs:** once the Packages table has rows, the session count comes from the table (the single "Sessions in this pack" number is retired), so the two never disagree.
- **Changing options later** regenerates the combinations. Check the table before you save.
:::

## Questions
