WooCommerce · Guide
How to Create Variable Products in WooCommerce

Short answer
To add a variable product in WooCommerce, go to Products, add a new product, and choose Variable product in the Product data box. Add attributes such as Size and Color, tick Used for variations, save them, then generate or add variations. Set a regular price, SKU, and stock level for each variation, then publish the product.
Key takeaways
- A variable product is one listing with several buyable options, each with its own price, SKU, stock level, and image.
- Global attributes created under Products > Attributes can be reused across products, while custom attributes belong to one product only.
- A regular price is required for each variation, and variations without prices do not show in the store.
- Track stock at the variation level when each option has its own count, or at the product level when all options share one count.
- Since WooCommerce 11.1, each variation can carry its own gallery of images, not just one photo.
What is a variable product in WooCommerce?
A variable product is one product listing that sells several options, such as sizes or colors, with a separate price, SKU, stock level, and image for each option.
WooCommerce lists 4 default product types: Simple, Grouped, External/Affiliate, and Variable, according to its product editor guide. A variable product suits a T-shirt in small, medium, and large sizes in different colors, as the variable products guide shows. Each choice a shopper makes is called a variation.
A variation is one exact combination, such as a large blue T-shirt. The parent product holds the shared name, description, and images, while each variation holds its own buyable details. If you are new to the plugin, read what WooCommerce is first.
What do you need before you start?
You need WooCommerce installed and active, a product photo, a list of options, and a price and stock count for each option.
WooCommerce is free core software. Its WordPress.org page lists PHP 7.4 or greater as required, with PHP 8.0 or greater recommended, plus WordPress 7.0 or greater.
The same page recommends a WordPress memory limit of 256 MB or greater and HTTPS support. Check those limits with your host before you build a large catalog.
WooCommerce 11.3.0 was released on November 11, 2026, according to the WooCommerce 11.3.0 release notes. A follow-up changelog for 11.3.1 is dated November 19, 2026, on the WooCommerce plugin page.
The public WooCommerce repo on GitHub lists 10,608 stars and 74,483 commits, checked November 2026. Plan about 30 to 60 minutes for your first variable product, and less once your attributes exist.
How do you create global attributes for variations?
Create reusable attributes under “Products > Attributes” when the same option, such as Size, will appear on more than one product.
Global attributes are shared across products, while custom attributes belong to one product only, as the variable products guide explains. Use global attributes for options you repeat, such as Size, Color, or Material. Use a custom attribute only for a detail that fits one product.
Follow these steps to create a global attribute:
- Go to “Products > Attributes” in your WordPress admin.
- Enter a name, such as “Size”, and a slug if you want a set one.
- Choose the default sort order for its values.
- Click “Add attribute”.
- Click “Configure terms” next to the new attribute.
- Add each value, such as Small, Medium, and Large, one at a time.
- Repeat the process for each attribute, such as Color.
How do you add a variable product step by step?
Choose “Variable product” in the “Product data” box, add attributes, tick “Used for variations”, save them, then generate or add variations.
The variable products guide lists these steps. Work through them in order, and save before you move to the next tab.
- Go to “Products > Add New Product” and enter the product name.
- Choose “Variable product” from the “Product data” dropdown.
- Add a short description and a main product image.
- Open the “Attributes” tab.
- Add an existing global attribute, or click “Add New” to make a custom one.
- For a custom attribute, type the name and separate values with a pipe, such as “Medium | Large | XL | XXL”.
- Tick “Visible on the product page” if shoppers should see the attribute in the “Additional Information” section.
- Tick “Used for variations” for every attribute that creates a choice.
- Click “Save attributes”.
- Open the “Variations” tab.
- Choose “Generate variations” to make every combination, or “Add manually” to pick only the ones you sell.
- Click “Go” if you chose to generate them.
- Open each variation and add its price, stock, SKU, and image.
- Click “Save changes”, then click “Publish” or “Update”.
The “Product data” box defaults to “Simple product”, so check the dropdown before you add attributes, as the product editor guide notes. If you forget to tick “Used for variations”, the attribute will not appear in the “Variations” tab.
How do you set a price, SKU, and stock for each variation?
Open each variation, enter a regular price, then add a SKU, stock quantity, weight, dimensions, shipping class, and tax class as needed.
A regular price is required for each variation, and variations without prices do not show in your store, according to the variable products guide. That rule is the most common cause of a missing variation. Set the price first, then fill in the other fields.
Each variation can hold its own image, SKU, GTIN, UPC, EAN, or ISBN, sale price, cost, weight, dimensions, shipping class, tax class, and description. A variation can also be marked downloadable or virtual. Mark it virtual when it needs no shipping, and downloadable when shoppers get a file after payment.
Keep SKUs unique across your store. The product editor guide says each SKU must be unique, and it gives “SKU-501-RED” as an example format. If you set a SKU at the product level but leave it blank on a variation, the variation uses the product level SKU.
| Variation field | What to enter | When it matters |
|---|---|---|
| Regular price | The price for that exact option | Always, it is required |
| Sale price | The lower price during a sale | Only during a sale |
| SKU | A unique code, such as TSHIRT-BLUE-L | For stock, orders, and search |
| Stock quantity | How many of that option you hold | When you track stock per option |
| Weight and dimensions | Size and weight for that option | When shipping cost differs by option |
| Shipping class | A class such as heavy or light | When rates differ by option |
| Tax class | A class such as standard or reduced | When tax differs by option |
You can set a sale price with a schedule. The product editor guide says a scheduled sale price stops showing at 11:59 pm on its end date.
How do you set a default variation and order options?
Set default form values at the top of the “Variations” tab after you create at least one variation, and drag attributes into the order shoppers should see them.
With default values set, shoppers can add the product to the cart without making a selection first, as the variable products guide explains. You can only set default form values after creating at least one variation. Pick your most sold option as the default, such as Medium in Black.
Order matters on the product page. The selection fields show in the same order you sort attributes in the admin area, according to the same guide. Drag attributes into your preferred order on the “Attributes” tab, then click “Save attributes”.
For global attributes, change the default sort order under “Products > Attributes” by clicking “Edit” on the attribute. If its sort order is “Custom Ordering”, open “Configure terms” and drag the values into order.
For custom attributes, the values show in the order you typed them, so retype them in the right order if needed.
If you have more than 15 variations, navigation arrows appear at the top and bottom of the list, according to the variable products guide. Click “Save changes” at the bottom to finish.
How do you manage stock across variations?
Track stock at the variation level when each option has its own count, or at the product level when all options share one count.
WooCommerce offers product level, variation level, and mixed stock control, as the variable products guide explains. Product level stock sets one quantity that all variations share. That fits a product sold with or without a digital download, where the physical count is the same either way.
Variation level stock sets a separate count for each option. The guide gives this example: blue 5, green 10, and red 15.
When a shopper buys a red T-shirt, only the red count falls. Use this setup for sizes and colors, where each option has its own shelf count.
To set stock per variation, open the “Variations” tab, expand a variation, tick “Manage stock?”, and enter the stock quantity. You can also set backorders and a low stock threshold there. When stock hits the threshold, WooCommerce sends a low stock email.
How do you hide out-of-stock variations?
Turn on “Hide out of stock items from the catalog” under “WooCommerce > Settings > Products > Inventory”, and track stock at the variation level with backorders off.
That setting hides out-of-stock variations from the dropdowns on product pages, so shoppers only see options they can buy, according to the variable products guide.
It only works when all 4 of these points are true: the hide setting is on, stock is managed at the variation level, the variation stock quantity is 0 or its status is “Out of stock”, and backorders are off for that variation.
If any variation allows backorders, it stays visible even at zero stock. If you manage stock at the parent product level, all variations stay in the dropdown. Pick one method and stick to it for each product.
How do you add images to each variation?
Open a variation, click the image placeholder to set its main photo, then click “Manage” next to “Variation gallery” to add more photos for that option.
Since WooCommerce 11.1, each variation can carry more than one image, according to the variable products guide. The first image in the gallery becomes the variation's main image. When a shopper picks a variation, WooCommerce swaps the product gallery to that variation's images.
The feature started as an opt-in in WooCommerce 10.9, with a gallery for each variation beyond the single featured image, according to the developer post on variation galleries.
That post also says the old Additional Variation Images extension is merged into core and offered free, out of the box. Stores that used the extension had their data moved in batches of 250 variations per run, with no manual step needed.
Test the gallery with your theme. The variable products guide says the core gallery works with the classic gallery and the block-based gallery.
If it does not change after a shopper picks a variation, check that your theme uses a standard WooCommerce gallery. Also check your WooCommerce settings before you add tax classes per variation.
How do you check that your variable product works?
Open the live product page, pick each option, and confirm the price, image, and stock message change, then add one variation to the cart.
Shoppers must pick all required options before they can add a variable product to the cart, as the variable products guide states.
After they pick every option, the page shows the matching variation price, image, and stock state. On shop and archive pages, a variable product may show a price range instead of one price.
Run this check for each variation:
- Open the product page in a private browser window.
- Pick the first option, such as Size, and watch the next dropdown update.
- Pick the second option, such as Color, and confirm the price and image change.
- Try a combination you do not sell and confirm the page says no product matched.
- Add a variation to the cart and confirm the cart shows the right option.
- Repeat steps 2 to 5 for the other variations.
- Check the product on a phone, since dropdowns and galleries can differ there.
If a variation is missing, check that it has a regular price and is enabled. For sales data after launch, use WooCommerce analytics to see which options sell.
Dropdowns behave in 2 ways. When a variable product has 30 or fewer variations, the dropdowns are dynamic, so picking a size limits the color list to options sold in that size, according to the variable products guide.
With more than 30 variations, the dropdowns stay static and show all options. An unavailable pick shows the message "Sorry, no products matched your selection. Please choose a different combination."
What mistakes should you avoid?
Avoid generating every combination, leaving prices blank, and using “Any” values without a clear order, because each one creates options you cannot sell or stock you cannot track.
Generating every combination fills a store with options you do not sell. Three sizes in 4 colors makes 12 variations, and a third attribute can push that count past 30 fast. Add variations by hand when many combinations do not exist.
Watch these common errors:
- Leaving a regular price blank, so the variation never shows in the store.
- Forgetting to tick “Used for variations” on an attribute.
- Using a custom attribute for an option that repeats across products.
- Setting the same SKU on 2 variations, since each SKU must be unique.
- Mixing product level and variation level stock without a plan.
- Using “Any Size” or “Any Color” on some variations and exact values on others.
- Publishing before you pick each option on the live page.
The “Any” choice needs care. WooCommerce advises you to define all attributes on all variations, as the variable products guide states.
When duplicates exist, WooCommerce uses the first match from the top of the sorted variation list, so sort the most exact variations first and the least exact last. Price all such variations the same and use product level stock if you use “Any” values.
Use bulk actions to fix prices across many variations at once. Open “Product data > Variations”, open “Bulk actions”, and pick "Set sale prices to regular prices decreased by (fixed amount or percentage)".
The guide gives this example: a regular price of 100 minus 15 gives a sale price of 85, while a 20% cut gives 80. Check a few variations after you run the action.
Frequently asked questions
Do I need a paid plugin to add variable products in WooCommerce?
No, variable products are built into WooCommerce core, so you do not need to buy an extension to offer sizes, colors, or other options. You can create attributes, generate variations, and set a price and stock level for each one from the product editor. Paid extensions only add extras such as color swatches or bulk editing tools.
What is the difference between an attribute and a variation?
An attribute is the option type, such as Size or Color, while a variation is one exact combination a shopper can buy, such as a large blue T-shirt. Attributes define the choices, and variations carry the price, SKU, stock, and image for each choice. An attribute marked Used for variations is what lets you create variations from it.
Why is my variation not showing on the product page?
The most common cause is a missing regular price, since variations without prices do not show in the store. Check that the variation is enabled and that its attribute values match the ones you set on the product. Also check that it is in stock or that backorders are allowed, and that the hide out-of-stock setting is not hiding it.
How many variations can a WooCommerce product have?
WooCommerce does not set a fixed limit in its variable products guide, but the way dropdowns work changes at 30 variations. With 30 or fewer variations, the dropdowns update as shoppers pick options. With more than 30, the dropdowns stay static and show all options, so shoppers may pick a combination that does not exist.
Can each variation have a different image?
Yes, each variation can have its own main image, and since WooCommerce 11.1 each variation can also carry its own gallery of images. When a shopper picks a variation, the product gallery swaps to show that variation's images. The first image in the variation gallery becomes that variation's main image.
Should I use global or custom attributes?
Use global attributes when the same option appears on more than one product, such as Size or Color, because you can manage the values in one place under Products and Attributes. Use a custom attribute only for a detail that belongs to a single product. Global attributes also keep spelling and order consistent across your store.
Sources
- Variable Products Documentation WooCommerce
- WooCommerce Product Editor settings WooCommerce
- Adding and Managing Products WooCommerce
- WooCommerce 11.3.0: Release notes WooCommerce Developer Blog
- Bringing Variation Galleries into Core WooCommerce Developer Blog
- WooCommerce - WordPress plugin WordPress.org
- woocommerce/woocommerce GitHub
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


