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

# Manage variants

> Create and organize product variants with different attributes like size, color, or configuration options

{/* AUDIT NOTE: Variant management UI not found on the product creation form. The product form has General Information, Advanced settings (Product type, Unit of measure, Units per pack, Language), Linked catalogs, and Price sections. Variant options are configured globally under Products & pricing > Product options > Setup Product variant options. The variant creation/editing flow within an individual product was not tested in the demo account. All step labels below remain as TODOs. */}

Product variants let you offer the same base product with different options such as size, color, tier, or billing frequency. Each variant has its own SKU, price, and inventory tracking while sharing common product details.

You can create variants manually or generate them automatically from attribute combinations. Variants appear as selectable options when sales reps add the product to a quote.

## Prerequisites

* **Admin** or **Manager** role
* At least one product in your Catalog

## Access the variants section

Navigate to **Products & pricing** → **Products** → select a product → **\[VARIANTS TAB]**. {/* TODO: verify tab/section name for variants within a product */}

## Create variants manually

<Steps>
  <Step title="Add a new variant">
    Click **\[ADD VARIANT BUTTON]**. {/* TODO: verify button label */}
  </Step>

  <Step title="Configure variant details">
    Fill in the required fields:

    * **\[VARIANT NAME FIELD]**: descriptive name (e.g., "Premium - Monthly")
    * **SKU**: unique identifier for this variant
    * **Price**: base price for this variant
    * **\[ATTRIBUTE FIELDS]**: custom attributes like size, color, or tier {/* TODO: verify how attributes are assigned */}
  </Step>

  <Step title="Save the variant">
    Click **\[SAVE BUTTON]** to add the variant to the product.
  </Step>
</Steps>

## Generate variants from attributes

<Steps>
  <Step title="Open the variant generator">
    Click **\[GENERATE VARIANTS BUTTON]**. {/* TODO: verify button label */}
  </Step>

  <Step title="Select attributes">
    Choose which attributes to use for variant generation (e.g., Size: Small, Medium, Large; Color: Red, Blue).

    Qwoty creates all possible combinations automatically.
  </Step>

  <Step title="Review and adjust">
    Review the generated variants. Update pricing or remove unwanted combinations before saving.
  </Step>

  <Step title="Save all variants">
    Click **\[SAVE ALL BUTTON]** to create the variants in your catalog.
  </Step>
</Steps>

<Note>
  Generating variants from 3 sizes and 4 colors creates 12 unique variants. Plan your attribute structure before generating to avoid duplicate cleanup.
</Note>

## Edit an existing variant

Click the **\[EDIT ICON]** {/* TODO: verify icon or action */} next to any variant in the list. Update the fields and click **\[SAVE BUTTON]** to apply changes.

Changes to variant pricing or attributes do not affect existing quotes. Only new quotes reflect the updated configuration.

## Delete a variant

Click the **\[DELETE ICON]** {/* TODO: verify icon or action */} next to the variant you want to remove. Confirm the deletion in the modal.

<Warning>
  You cannot delete a variant that appears in any existing quote, even if the quote is in Draft status. Archive the variant instead to hide it from new quotes.
</Warning>

## What happens next

Once you create variants, sales reps see them as selectable options when adding the product to a quote. The selected variant's SKU and price automatically populate the quote line item.

If you're using the Product Configurator, you can map variants to visual configuration rules for an interactive selection experience.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Variants don't appear when adding the product to a quote">
    Verify that:

    * The product is active in your Catalog
    * The Pricebook includes the product
    * At least one variant is active and has a price defined
  </Accordion>

  <Accordion title="Cannot delete or edit a variant">
    The variant may be locked because it appears in an existing quote. Check the **\[USAGE TAB]** {/* TODO: verify if usage tracking exists */} to see where the variant is referenced.

    Archive the variant to prevent new usage while preserving historical data.
  </Accordion>

  <Accordion title="Generated too many unwanted variants">
    Delete variants individually or use **\[BULK DELETE OPTION]** {/* TODO: verify if bulk actions exist */} to select multiple variants at once. Consider using fewer attributes or attribute values to simplify your catalog.
  </Accordion>
</AccordionGroup>

## Related resources

<CardGroup cols={2}>
  <Card title="Create a product" icon="box" href="/user-guide/catalog/how-tos/create-product">
    Add products to your Catalog before creating variants
  </Card>

  <Card title="Product Configurator" icon="sliders" href="/user-guide/catalog/how-tos/configure-discounts">
    Build visual configuration rules for variant selection
  </Card>

  <Card title="Pricebooks" icon="tags" href="/user-guide/catalog/introduction">
    Learn how Pricebooks apply pricing to product variants
  </Card>

  <Card title="Add products to quotes" icon="file-invoice" href="/user-guide/quotes/how-tos/add-products-and-options">
    Use variants when building quotes for customers
  </Card>
</CardGroup>