Learn how to edit a multi-variant product in Spree Commerce.
Editing multi-variant products is a bit more involved than single-variant ones, since each variant can have unique details - such as pricing, stock levels, or media.This guide will show you how to manage variant options, edit individual variants, and tailor settings for specific combinations.
To get started, go to the Products tab in the admin dashboard, and click on the product you’d like to update to open the product editor.Scroll down to the Variants section where you should see all associated product variants.This section is where you can manage all settings related to the product’s variants, including options, pricing, inventory, and more.
At the top of the Variants section, you’ll see the product’s assigned Options (e.g., Color and Size) along with their respective values (e.g., White, Blue, S, M, etc.).
Beneath the Options editor, you’ll see a list of product variants generated by the Option Value combinations.For example, 2 colors × 3 sizes = 6 total variants.Each variant row includes fields for:
Price
Quantity
Edit button (for advanced settings)
You can adjust price and stock directly in this view by entering new values into the respective fields.
In some cases, variants may differ significantly, whether it be by size, weight, barcode, or even media. For these situations, it’s helpful to manage them individually.To edit a variant, click Edit to open the variant editor.
If you’ve made changes to the main product, be sure to click Update before editing a variant. Otherwise, those changes may be lost when switching views.
Here you can modify the following fields:
SKU
Barcode
Tax Category
Discontinue On
Dimensions
Weight
Price
Compare At Amount
Quantity
Backorderable
Media
Remember to click Update to save any changes you’ve made.
You can upload images specific to each variant to improve the product detail page experience.For example, if you sell a shirt that’s available in White and Blue, upload white-shirt images to the White variants and blue-shirt images to the Blue variants.This ensures that when a customer selects a variant on the storefront, the most relevant images are shown automatically.
Since not all combinations of color, size, etc., may be valid for sale, you may wish to delete some variants entirely.If there are variants you don’t offer:
Check the box next to the unwanted variant(s)
Click Delete selected
Deleting a variant will remove it’s row from the list. To undo this, reconfigure the Options and then click Update at the top/bottom of the page.