How to Add a Configurable Product in Magento
A configurable product in Magento allows you to sell a single product with multiple variations that customers can choose from. Common examples include clothing with different sizes and colors, shoes with different sizes, or electronics with different storage options.
Unlike a simple product, a configurable product is made up of individual simple products, with each variation having its own SKU, inventory, and price.
This guide explains how to create a configurable product in Magento from the Admin Panel.
What Is a Configurable Product?
A configurable product is a parent product that provides customers with selectable options.
For example, a T-shirt could have:
- Color: Black, White, Blue
- Size: Small, Medium, Large
Each combination can be represented by a separate simple product.
For example:
| Variation | SKU |
|---|---|
| Black / Small | TS-BLK-S |
| Black / Medium | TS-BLK-M |
| White / Small | TS-WHT-S |
| White / Medium | TS-WHT-M |
Magento displays these simple products together as one configurable product on the storefront.
Before You Start
Before creating a configurable product, prepare:
- Product name
- Product images
- Product description
- Price
- SKU structure
- Product attributes such as size or color
- Inventory quantities
- Product category
The attributes used for configurable options must be suitable for use with configurable products.
Step 1: Log in to Magento Admin
Log in to your Magento Admin Panel.
Go to:
Catalog → Products
Click:
Add Product
From the product type menu, select:
Configurable Product
Magento will open the product creation form.
Step 2: Enter the Product Name
Enter a name for the main product.
For example:
Premium Cotton T-Shirt
The name should describe the product rather than one particular variation.
Step 3: Enter the SKU
Enter a unique SKU for the configurable product.
For example:
TS-PREMIUMMagento will use individual SKUs for the associated simple products.
A consistent SKU structure makes inventory management easier.
Step 4: Enter the Product Price
Enter the base price for the configurable product.
For example:
999Depending on your Magento configuration and product setup, individual simple-product variations can have pricing differences.
For example:
- Small: ₹999
- Medium: ₹999
- Large: ₹1,099
This allows customers to see the appropriate price when selecting a variation.
Step 5: Add Product Attributes
Configurable products require attributes that customers can use to select variations.
Common configurable attributes include:
- Size
- Color
- Material
- Storage
- Capacity
- Length
For example, for a T-shirt you could use:
Color
- Black
- White
- Blue
Size
- Small
- Medium
- Large
If the required attributes do not exist, you may need to create them before continuing.
Step 6: Create Configurable Options
Find the configurable product configuration area and select:
Create Configurations
Magento will display attributes that can be used to create product variations.
Select the attributes you want customers to use.
For example:
- Color
- Size
Click:
Next
Magento will display the available attribute values.
Step 7: Select Attribute Values
Select the values you want to use for the product.
For example:
Color
- Black
- White
- Blue
Size
- Small
- Medium
- Large
Magento can generate combinations from the selected values.
For example:
- Black / Small
- Black / Medium
- Black / Large
- White / Small
- White / Medium
- White / Large
- Blue / Small
- Blue / Medium
- Blue / Large
You do not have to create every possible combination if some combinations are not available.
Step 8: Configure the Product Variations
Magento will generate the associated simple products based on the selected attribute combinations.
You can configure details such as:
- SKU
- Price
- Quantity
- Weight
- Images
For example:
| Variation | SKU | Price | Quantity |
|---|---|---|---|
| Black / Small | TS-BLK-S | ₹999 | 20 |
| Black / Medium | TS-BLK-M | ₹999 | 25 |
| Black / Large | TS-BLK-L | ₹1,099 | 15 |
| White / Small | TS-WHT-S | ₹999 | 18 |
| White / Medium | TS-WHT-M | ₹999 | 22 |
Each variation is treated as an individual simple product in Magento’s inventory system.
Step 9: Configure Images for Variations
Magento allows you to assign images to individual variations.
For example, you could assign:
- Black T-shirt image → Black variations
- White T-shirt image → White variations
- Blue T-shirt image → Blue variations
This improves the shopping experience because customers can see the appropriate product image when they select a color.
Depending on your Magento version and theme, image switching behavior can vary.
Step 10: Configure Inventory
Set the quantity available for each variation.
For example:
Black / Small = 20
Black / Medium = 25
Black / Large = 15Magento can manage inventory separately for each associated simple product.
This is one of the major advantages of configurable products.
If the Black / Medium variation sells out, Magento can mark that particular variation as unavailable while the other variations remain available.
Step 11: Add Product Description
Enter a detailed description for the main configurable product.
Explain:
- Product features
- Materials
- Available variations
- Benefits
- Specifications
- Care instructions
- Warranty information
For example:
The Premium Cotton T-Shirt is made from soft, breathable cotton and is available in multiple colors and sizes. Select your preferred color and size before adding the product to your cart.
Step 12: Add Product Images
Upload the main product images under Images and Videos.
Use high-quality images that clearly represent the product.
Consider adding:
- Front view
- Back view
- Side view
- Detail images
- Variation-specific images
Optimize images before uploading them to avoid unnecessarily increasing page size.
Step 13: Assign a Category
Under the Categories section, select the appropriate category.
For example:
Clothing → T-Shirts
You can assign the product to more than one relevant category when necessary.
Step 14: Configure Product Visibility
Set the product’s visibility appropriately.
For a normal configurable product, select:
Catalog, Search
This allows customers to discover the product through category pages and Magento’s search functionality.
Step 15: Enable the Product
Set the product status to:
Enabled
If you are still preparing the product, you can leave it disabled until all information and variations have been verified.
Step 16: Configure Product URL
Magento can automatically create a URL key from the product name.
For example:
premium-cotton-t-shirtA clean product URL could look like:
https://example.com/premium-cotton-t-shirt.htmlUse a short and descriptive URL.
Step 17: Add Related Products and Upsells
You can improve product discovery by adding:
Related Products
Products that customers may purchase alongside the current product.
Up-Sells
Alternative or upgraded products that may provide additional features.
Cross-Sells
Complementary products that customers may want to purchase with the configurable product.
For example, a T-shirt could have jeans or a jacket as related products.
Step 18: Save the Configurable Product
After completing the product information and variations, click:
Save
Magento will save the configurable product and its associated simple products.
If Magento reports missing information, correct the highlighted fields and save again.
Step 19: Test the Product on the Storefront
Open the product page on your Magento storefront.
Verify that customers can:
- Open the product page.
- Select a color.
- Select a size.
- See the correct product image.
- See the correct price.
- See availability for the selected variation.
- Enter a quantity.
- Add the selected variation to the cart.
Add different combinations to the cart and confirm that Magento identifies the correct simple product.
Example Configurable Product
Suppose you sell a T-shirt with three colors and three sizes.
Your configurable product could be:
Product: Premium Cotton T-Shirt
Attributes:
- Color: Black, White, Blue
- Size: Small, Medium, Large
Magento can create nine simple-product combinations:
| Color | Size | SKU |
|---|---|---|
| Black | Small | TS-BLK-S |
| Black | Medium | TS-BLK-M |
| Black | Large | TS-BLK-L |
| White | Small | TS-WHT-S |
| White | Medium | TS-WHT-M |
| White | Large | TS-WHT-L |
| Blue | Small | TS-BLU-S |
| Blue | Medium | TS-BLU-M |
| Blue | Large | TS-BLU-L |
Customers see one T-shirt product page but can select their desired color and size.
Configurable Product vs Simple Product
| Feature | Simple Product | Configurable Product |
|---|---|---|
| Product variations | Usually none | Multiple variations |
| Customer selections | Limited | Yes |
| Individual SKU | Yes | Each variation has its own SKU |
| Individual inventory | Yes | Yes, per associated product |
| Example | USB cable | T-shirt with size and color |
| Product structure | Single product | Parent + associated simple products |
Common Problems
Configurable Options Are Not Available
If an attribute cannot be selected when creating configurations, check whether the attribute is configured correctly for use with configurable products.
You may need to review the attribute configuration under:
Stores → Product → Attributes
The exact menu labels can vary depending on the Magento version.
A Variation Does Not Appear
Check that:
- The associated simple product is enabled.
- The simple product has the correct attribute values.
- Inventory is available.
- The product is assigned to the appropriate website.
- The configurable product is enabled.
The Wrong Image Appears
Check the images assigned to the associated simple products and verify that your theme supports variation-based image switching.
A Variation Shows as Out of Stock
Check the inventory quantity and stock status of the associated simple product.
For Magento installations using MSI (Multi-Source Inventory), also check the relevant source and stock assignment.
Price Does Not Change
Check the price configuration of the associated simple products and the configurable product’s pricing settings.
Also remember that the active Magento theme can influence how variation prices are displayed.
Best Practices
Plan Attributes Before Creating Products
Decide which characteristics customers need to select before creating the configurable product.
Use Clear SKUs
Create a consistent SKU structure for every variation.
Keep Inventory Accurate
Track inventory for each associated simple product rather than treating the entire configurable product as one stock item.
Use Variation Images
For products such as clothing, assigning appropriate images to color variations can significantly improve the shopping experience.
Avoid Unnecessary Combinations
Do not create combinations that you do not actually sell. For example, if a particular color is unavailable in Large, there is no need to create that variation.
Test Every Combination
Before publishing the product, test the available combinations on the storefront and verify pricing, inventory, images, and cart behavior.
Conclusion
Creating a configurable product in Magento involves creating a parent product and associating it with simple products that represent individual variations. Start by creating a configurable product from Catalog → Products, choose attributes such as size or color, generate the required configurations, and then configure inventory, pricing, SKUs, and images for each variation.
Once saved, thoroughly test the product from the customer’s perspective. A properly configured product makes it easy for shoppers to select the exact variation they want while allowing Magento to manage inventory for each individual option.