> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding Variants and Options in Eaglecart

> Learn the difference between variants and options in Eaglecart, when to use each, and how they work together, with practical examples.

[Help Center](https://help.eaglecart.com/introduction.md)

[Products](https://help.eaglecart.com/products.md)

Understanding variants and options

# Understanding variants and options

Variants and options both let customers make choices on a product page, but they work very differently. Choosing the right one keeps your stock accurate and your products easy to buy.

## Variants: versions of a product

Variants are versions of the same product that differ by something like color, size or material. Each variant is stocked and priced on its own.

**Example:** a T-shirt in Black / M and White / L. Each has its own:

* Price, original price and cost
* Stock, per location
* SKU and barcode
* Weight, dimensions, country of origin and HS code
* Image, and a color swatch for color values

## Options: inputs and extras

Options add inputs or paid extras to the product page. They don't create separately stocked versions.

**Examples:**

* "Engraving text": a text box.
* "Delivery date": a date picker.
* "Gift wrap (+AED 10)": a paid checkbox.

## Which should I use?

| Question | Use |
| - | - |
| Does each version have its own stock? | Variant |
| Does each version have its own price, SKU or barcode? | Variant |
| Does each version have its own photo? | Variant |
| Is the customer personalizing the same item, for example with a name? | Option |
| Is the customer adding a paid extra, such as gift wrap? | Option |
| Do you need a date, time, number or file from the customer? | Option |

**Rule of thumb:** use variants when each version is stocked and priced on its own. Use options when the customer personalizes or adds to the same item.

## Using both together

A product can have variants and options. For example, a personalized mug:

* **Variants:** Color (White, Black). Each color has its own stock.
* **Options:** "Name to print" (Text, required) and "Gift box (+AED 15)" (Checkbox).

The customer picks a color variant, types a name and ticks the gift box. They pay the variant's price plus AED 15.

## Variant price vs option price

* A **variant's price** is the full price of that version, set on the variant.
* An **option choice's price** is added on top of the product or variant price. A choice with price 0 is free.

## Limits at a glance

| What | Limit |
| - | - |
| Variant levels | 3, for example Color, Size, Material |
| Variants per product | 100 |
| Images per variant | 1 |
| Options per product | 100 |
| Choices per option | No limit |
| Option name | Required, up to 255 characters |

## Common questions

**How do I sell the same product in different colors and sizes?**
Add variants with two levels, such as Color and Size. See [Create product variants](https://help.eaglecart.com/products/create-variants.md).

**Can each variant have different stock?**
Yes. Each variant has its own stock per location.

**How do I charge extra for gift wrapping?**
Add a Checkbox option with a choice priced at the extra amount. See [Paid options, quantities and selection rules](https://help.eaglecart.com/products/paid-options-quantities-and-rules.md).

**How do I collect engraving text?**
Add a Text option, and make it required if every order needs it. See [Add text, number, date, time and media options](https://help.eaglecart.com/products/text-number-date-time-media-options.md).

## Keep reading

* **Next:** [Create product variants](https://help.eaglecart.com/products/create-variants.md): set up colors and sizes.
* [Introduction to product options](https://help.eaglecart.com/products/introduction-to-options.md): add inputs and extras.
* [Pricing, costs and discounts](https://help.eaglecart.com/products/pricing-costs-and-discounts.md): product pricing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.