Skip to content

[IMP] Sales: adding/deleting variants clarification #15351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

[IMP] Sales: adding/deleting variants clarification #15351

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions content/applications/sales/sales/products_prices/products/variants.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -300,5 +300,39 @@ impacts that can be taken advantage of throughout the Odoo database.
.. note::
Changes to the product template automatically apply to every variant of that product.

Adding and deleting attributes from product variants
====================================================
Comment on lines +303 to +304
Copy link
Contributor

@Felicious Felicious Nov 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really cool troubleshooting section and documenting an edge case! To better conceptualize the impact, let's use an example. Start with some attributes with multiple values, add 1 attribute value to an order, then delete the attribute, and show that the attribute value that was never used gets deleted and the value that was used gets archived (and specify where)


When attributes are added or deleted from products, variants that have already been created are
affected. Depending on whether or not these variants have been used in orders, they are archived or
deleted and recreated.

- Variants that have not been used in an order are deleted and recreated with the new attributes.
This may result in the deletion of additional customizations, depending on how the variants were
configured.
- Variants that have been previously used in one or more orders are archived and removed from the
product catalog instead of being deleted.

.. example::
A business offers leather motorcycle jackets with the following attributes and values for a total
of 27 product variants:

- Size: Small, Medium, Large
- Color: Black, Brown, Natural
- Material: Leather, Vegan Leather, Premium Leather

Due to rising costs, the business makes the decision to stop offering different leathers and
removes the "Material" attribute from the product form. This has the following effects:

- Any leather jacket variants that have been sold will be archived
- Any leather jacket variants that have not been sold will be deleted
- A new set of variants using just Size and Color attributes will be created, for a total of 9
product variants

The business owner can find archived product variants by navigating to :menuselection:`Sales app
--> Products --> Product Variants`, clicking the drop-down in the search bar, and finally
clicking the :guilabel:`Archived filter`. Any deleted variants and their customizations will be
lost.

.. seealso::
:doc:`import`