Manage Product Variants in Medusa Admin

In this guide, you'll learn how to manage the variants of a product.

View Product Variants#

To view the variants of a product:

1. Go to the Products page from the sidebar.
2. Select a product from the list to open its details page.
3. In the Variants section, you can see the list of variants for the product. You can search and filter them.

If you click on a variant, you can see its details in a separate page.

Create Product Variant#

You can only create a product variant if there are option combinations that aren't created as a variant yet. For example, if you created a new option or deleted an existing variant, you can create a new variant.

To create a product variant:

1. Click the "Create" button at the top right of the Variants section.
2. In the form that opens, there are two steps:
   1. Details step:
      • Enter the variant's title and optionally SKU.
      • For each option, such as Color and Size, choose the variant's value.
      • Enable the "Manage Inventory" toggle if you want Medusa to track the inventory of this variant. If disabled, the variant is always considered in stock.
      • Enable "Allow backorders" if you want to allow customers to purchase the variant even if it's out of stock.
      • Enable "Has inventory kit" if you want to add multi-part or bundled products. This will show a third step "Inventory Kits" after the Prices step.
   2. Prices step: Use the Bulk Editor to set the variant's prices for each currency and region in your store.
   3. Inventory Kits step (optional): If you enabled "Has inventory kit", you can add the parts of the kit in this step.
      • Choose an existing inventory item to be part of the kit.
      • Enter the quantity required for a single item of the variant. For example, if the variant is a bicycle and the inventory item is a wheel, you can enter 2 in the Quantity field to indicate that the variant requires two wheels.
      • To add more inventory items, click the "Add" button.
3. Once you're done, click the "Save" button.

Edit Product Variant Details#

To edit a product variant's general details:

1. Go to its product's details page.
2. In the Variants section, click on the at the variant's right.
3. Choose "Edit" from the dropdown.
4. In the side window that opens:
   • You can edit the variant's title, materials, option values (such as color or size), SKU, EAN, UPC, and barcode.
   • You can modify managing inventory, enabling or disabling managing inventory quantity in different locations.
   • You can modify allowing backorders, enabling or disabling customers from purchasing the variant even if it's out of stock.
   • You can edit the variant's attributes, including the variant's weight, height, width, length, MID code, HS code, and country of origin.
5. Once you're done, click the "Save" button.

Edit Product Variant Prices#

To edit the prices of product variants:

1. Go to its product's details page.
2. Click on the at the top right of the section.
3. Choose "Edit Prices" from the dropdown.
4. In the bulk editor, you can edit the price of each variant for the currencies and regions in your store.
5. Once you're done, click the "Save" button.

Manage Product Variant Inventory#

There are many ways to manage the inventory of a product variant. From the product's details page, you can manage the inventory of its variants using the bulk editor, providing you with an intuitive interface.

To manage the inventory of a product's variants:

1. Go to its product's details page.
2. Click on the at the top right of the section.
3. Choose "Edit stock levels" from the dropdown.
4. In the bulk editor, the rows are the inventory item(s) of each product variant, and the columns are inventory-related fields to edit, such as SKU and quantity in each stock location.
5. Once you're done, click the "Save" button.

Manage Product Variant Metadata#

Metadata is custom data that can be associated with the product variant in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the variant.

To manage the metadata of a product variant:

1. Go to its product's details page.
2. In the Variants section, click on a variant to go to its details page.
3. Click on the at the right of the section.
4. In the side window that opens:
   • Manage the key-value pairs in the table.
   • To add a new row of key-value pairs before or after a row:
     • Hover over the row and click the icon at its right.
     • Choose "Insert row above" or "Insert row below" from the dropdown.
   • To delete a row of key-value pairs:
     • Hover over the row and click the icon at its right.
     • Choose "Delete row" from the dropdown.
5. Once you're done, click the Save button.

Product Variant JSON Section#

The JSON section is useful for developers to view the raw product variant data in JSON structure. Developers can use this section to debug and troubleshoot issues related to the variant.

To view the JSON structure, click on the icon.

Delete Product Variant#

To delete a product variant:

1. Go to its product's details page.
2. In the Variants section, click on the at the variant's right.
3. Choose "Delete" from the dropdown.
4. Confirm the action by clicking the "Delete" button in the pop-up.