You can add variants to a product that comes in more than one option, such as size or color, and each combination of option values for a product can be a variant for that product. Variants can let you offer different versions of a product, such as sizes and colors, so customers can find exactly what they want.

For example, suppose that you sell T-shirts with two options: size and color. The size option has three values: small, medium, and large. The color option has two values: blue and green. One specific variant from these options is a small, blue T-shirt.

A list of variants available for a product is displayed on its product details page. You can also manage inventory for each variant from the Inventory page.

If you want to save specialized information for your variants, then you can add custom fields to your variant details pages by using metafields. At this time, product variant metafields can't be displayed to customers.

You can also connect category metafields to variant options, which allows you to reuse your data across products instead of having to recreate it each time.

Adding variants

You can add variants to a product that has more than one option, such as size or color. Each combination of option values for a product can be a variant of that product.

When you add a product, you can adjust the Price, Inventory, and Shipping settings for the product from the product details page. However, when you add variants to the product, you need to adjust those settings for each variant from the variant details page.

Considerations for adding variants

Before you add variants to your product, review the following considerations:

• You can create up to 2,048 variants for a product.
• Each product can have up to three options. The options can be different from product to product. For example, one product can use size, color, and style, and another product can use weight, finish, and material.
• You can use category metafields to create variant options. The data is reusable so that you have more consistent content. For example, if you need to change the name of your color from black to graphite, then you could make the change one time and it updates anywhere you connected that category metafield entry. When you use color entries as variant options, you can display variant options as swatches for color options on your storefront products pages.
• If you want to save specialized information for your variants, then you can add custom fields to your variant details pages by using metafields. If you use a compatible theme, then you can add references to your product variant metafields through the theme editor.
• If you have 50,000 or more variants in your store, then you're subject to a daily rate limit for uploading variants by using an app or CSV file import. You can add up to 1,000 new variants in a day before the limit is reached. If you're on the Shopify Plus plan, then the daily rate limit for uploading variants doesn't apply to your store.

Considerations for adding more than 100 variants

Review the following considerations for adding more than 100 variants:

• You can have up to 250 media items, such as images, per product. Each variant can have one media item applied, which must be from the product’s media list. Learn more about adding product media.
• If you want specific product variants to display in collections and search result product grids, instead of only the main product listing being displayed, then consider using combined listings.
• Some third-party themes might not support more than 100 variants. Learn more about how to update a theme to support a higher variant count.
• Some theme app extensions, public apps, and sales channels might not support more than 100 variants. Contact the app developer directly for more information.
• The Stocky app and the legacy Order Printer app don't support more than 100 variants.
• Some custom apps might not support more than 100 variants. If a custom app uses the REST Admin API, then they must migrate to the GraphQL Admin API.

Add variants to a product

You can add options and option values to generate new variants for your product. After you save the variants, you can add prices to them.

Add a variant with category metafields

You can add variants by connecting a variant option to a category metafield. When variant options are connected to metafields, it makes data reusable across your store and content edits are much easier. For example, if you need to change the name of your color black to graphite, then you can edit the entry from the Content > Metaobjects page in your admin and the change will update everywhere the color is connected.

When you're adding a variant, a list of category metafields display that you can connect to or you can create a custom option.

Steps:

Edit variant options connected to a category metafield

You can add or edit variant options connected to a category metafield.

Steps:

Disconnect a category metafield from a variant

You can disconnect a category metafield from a variant.

Steps:

Migrate variant options to category metafields

If you've already created a product with variant options, then you can migrate your values to category metafields and quickly generate the multiple new variant combinations. If you use category metafields to create your variant options, then you can update variant option names in a single location and it updates wherever that category metafield value is connected.

For example, if you currently offer three sizes (Small, Medium, and Large) and two colors (Red and Blue), and you want to add a third color Yellow, then this method will create the 3 possible sizes of yellow variants at one time.

Connect the category metafield to an existing option by clicking the dynamic source icon ⛁;

Add values to an existing option

If you've already created a product with variant options, then you can add new values to it to quickly generate the multiple new variant combinations.

For example, if you currently offer three sizes (Small, Medium, and Large) and two colors (Red and Blue), and you want to add a third color Yellow, then this method will create the 3 possible sizes of yellow variants at one time.

Steps:

Add a variant manually

You can add variants one at a time. Before you can save a new variant, at least one of its option values need to be new. You can't save an exact duplicate of another variant that already exists.

Steps:

Add a variant by duplicating an existing variant

You can duplicate a variant to save time when adding similar variants, rather than entering the same details again. The duplicate variant has the same details as the original variant.

Before you can save a duplicated variant, you need to edit at least one of its option values. You can't save an exact duplicate of itself or another variant that already exists. You can only duplicate a variant in the Shopify admin on desktop or mobile.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, click the variant that you want to duplicate, and then click Duplicate.

4. Edit an option value to create an unique variant. You can add a new option value, or add one that is already in use for the product variants.

5. Optional: Add a different product image for each new variant. You can also add prices, quantities, SKUs, barcodes, HS codes, country/region of origin, and locations for the new variants, or use the defaults based on the product details.

6. Click Save.

Duplicate multiple variants in bulk

If you need to create a new variant with the same options as a variant that you've already customized, then you can use a bulk action to duplicate the existing variant and add a new option.

To use a bulk action to add new variants, you need to select multiple similar variants and duplicate their details and then change at least one option value.

For example, you might sell T-shirts with two options: Size and Color. Your blue and red shirts are well-stocked and cost the same, but all of your yellow shirts are limited-edition, cost more, and are stored at a different warehouse. If you wanted to introduce green as a new limited-edition color, then duplicating the yellow variants will save you time when setting quantities, prices, and locations for your green variants.

If a variant already exists, then duplicating a variant won't create a second copy. For example, you sell yellow T-shirts in small, medium, and large. You manually add a green T-shirt variant for size small. If you duplicate the color variant (yellow) to create green T-shirts in all available sizes, then the duplication will only create green T-shirts in medium and large, as the green T-shirt in size small already exists.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, select variants that you want to duplicate. The variants that you select need to have the same option value that you're adding, and different options values for all other options, such as green T-shirts in small and medium sizes.

4. Click .

5. In the DUPLICATE VARIANTS section, click the "...in another Option" based on the set of variants you selected.

6. In the Create duplicate variants dialog, enter the value for the new variants that you want to create, and then select the information to copy from the existing variants.

7. Click Duplicate.

Editing variants for an existing product

You can edit and remove variants for a product on its details page. This gives you the flexibility to change the variants that you sell for a product at any time. From the product details page, you can manage variant options and values, select variants to edit in bulk, or click individual variants to access the variant details page to make edits to that specific variant.

Edit variant details individually

You can edit your variant details individually on the variant details page.

Edit variant details in bulk

You can change some variant details from the product details page. To edit other details for multiple variants at one time, you can use the bulk editor.

Edit variants from the product details page

You can adjust the following details from the product details page:

• variant image
• variant price
• available inventory per location

Click a variant listing image to adjust the variant image. Click the variant listing price and then type in the new price.

To edit variant inventory, you need to filter by location. When you have filtered to a specific location, adjust the available inventory.

The top level variant of a group isn't a unique variant. If you adjust the top level listing's price or image, then all variant prices and images within the group change as well. To adjust an individual variant price or image, click the top level variant to open the group, then select the specific variant that you want to adjust. For available inventory, the top level group displays can't be edited. You must open the variant group to adjust each variant's available inventory individually.

Use the bulk editor

You can make changes to all details for multiple variants at one time using the bulk editor. For information on using the bulk editor, refer to Bulk editing products and variants.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, do one of the following:

   • To edit specific variants, select the variants that you want to edit using the checkboxes, and then click Bulk edit.
   • To edit all variants at one time, select the topmost checkbox, and then click Bulk edit.

4. Make the changes to your variants.

5. Click Save.

Edit variant options and values

You can add, remove, or edit variant options and option values.

Change the display order of variant options and values

When your customers view your products, variant options and values display in a particular order. You can change the display order.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, do any of the following:

   • To rearrange the variant option order, use the drag and drop handles ⋮⋮ next to the option.
   • To rearrange the option value order, click Edit next to the option, and then use the drag and drop handles ⋮⋮.

4. Click Save.

Editing a metafield for a variant

You can add custom fields to your variant details pages by using metafields. Metafields display in an editable table on your variant details pages. Each metafield displays the name that you select when you create your metafield definition. You can click in each table row to display the metafield type and its description, and then click in the field to enter a value.

If you have a compatible theme, then you can add references to your product variant metafields through the theme editor.

Delete a variant

If you don't want to sell a product with variants any more, then you need to delete all its variant options and values, including the default. Otherwise, the drop-down menu to select a variant continues to display to your customers.

To delete multiple variants at one time, use a bulk action.

Steps:

Find a variant ID

Variant IDs are sometimes needed to make theme code customizations that target specific product variants, or for reconciling migration or bulk product update information with a third-party app. If you need to find a variant ID, then you can do so from within your Shopify admin.

Find a variant ID for a product with variants

If a product has variants, such as different colors, sizes, or styles, then the variant ID is displayed in the browser address bar as part of the URL. This can be a quick way to determine the variant ID for an individual variant.

Steps:

1. From your Shopify admin, go to Products.

2. Click a product that has a variant.

3. In the Variants section, click the product variant that you want to view the product variant ID for.

4. Examine the URL in your browser's address bar. Your URL should be similar to the following URL example:

https://admin.shopify.com/store/shopname/products/1234567/variants/36485954240671

The number after /variants/ is the variant ID number. In this example, the variant ID is 36485954240671.

Find a variant ID for a product without variants

A product that has no variants still has a variant ID assigned to it. However, unlike a product with variants, the variant ID doesn't display in the browser address bar when you access the product details page from the Shopify admin.

You can access the variant ID for a product by displaying the complete product information in JSON format. This can be a quick way to determine the variant ID for an individual product.

To make the JSON formatting more readable, consider installing a JSON viewer extension in your browser, or leveraging the pretty-print capability that most modern web browsers have available by default.

Steps:

1. From your Shopify admin, go to Products.

2. Click a product that you want to find the variant ID for to open the product details page.

3. In the browser address bar, add .json to the end of the URL and hit Enter to reload the page in JSON.

4. Optional: If you don't have a JSON viewer extension installed, then activate the Pretty-print setting on the webpage to reformat the JSON file to be more user-friendly.

5. Locate the "product" > "variants" > "id" value. The beginning of the JSON file displays similar to the following example:

{
      "product": {
         "id": 12345678901234,
         "title": "Example Product",
         "body_html": "<p>This is an example product.</p>",
         "vendor": "Example Vendor",
         "product_type": "Test Items",
         "created_at": "2025-07-09T12:40:46-04:00",
         "handle": "example-product",
         "updated_at": "2025-07-09T12:40:50-04:00",
         "published_at": "2025-07-09T12:40:47-04:00",
         "template_suffix": "",
         "published_scope": "global",
         "tags": "demo, test",
         "status": "active",
         "admin_graphql_api_id": "gid://shopify/Product/12345678901234",
         "variants": [
            {
            "id": 11223344556677,
            "product_id": 12345678901234,
            "title": "Default Title",
            "price": "30.00",
      ......}
      .....]
      ....}
      ...}

In the example above, 11223344556677 is the product's variant ID.

Display variant IDs in bulk in a custom inventory report

The Product variant ID dimension is available to use in custom data explorations. This can be a useful way to display variant IDs for many products on a single report, and can be saved, printed, or exported. This data exploration includes all products by default, including draft products, but you can choose to filter the report to display only a subset of products.

Learn more about creating custom data explorations.

Steps:

1. From your Shopify admin, go to Analytics > Reports.

2. Click New exploration.

3. In the Metrics menu, apply the primary metric:

   1. Click ⊕.
   2. Select Percent of inventory sold.
   3. Click Apply.

4. In the Dimensions menu, apply the required dimensions:

   1. Click ⊕.
   2. Select Product title, Product variant title, and Product variant ID.
   3. Click Apply.

5. Optional: In the Filters menu, apply any filters to display a subset of products:

   • To display only products with no variants, apply the filter Product variant title > is > Default Title.
   • To display only products with variants, apply the filter Product variant title > is not > Default Title.

6. Optional: To save this data exploration as a custom report for later use, do the following actions:

   1. Click Save.
   2. In the Save report dialog, give your custom report a name, such as Product list including variant IDs.
   3. Click Save.

7. Optional: To export this data exploration, click > Export. Select your preferred export file format, and then click Export.

You can now read and record the variant IDs for all products displayed in the report.

Search, filter, and group variants

All your products variants are listed in the Variants section of the product details page. Variants are also grouped together by option. Searching and filtering your variant list can help you find the specific variants that you need to edit, review, or update.

You can search and filter option values to find specific variants, as well as filter by location to display available inventory for a specific location.

Learn more about searching, filtering, and sorting your list views in the Shopify admin.

Search and filter variants by option value

In the Variants section of the product details page, you can search for variants by title, and filter your variant list to display a subset of variants matching a specific option value. If your variants have more than one option, then you can add one filter for each option. Option filters can be used with the search for more specific results. If you add more than one filter, then only the variants that match all of the conditions are displayed.

For example, you sell a hat that comes in many sizes and colors. The small size hats in black are going to be discounted as part of a sale, so you need to adjust the price of that variant. You can open the variant search and filter, and from the Size option, select Small, then from the Color option, select Black. This will adjust the variant list to only display the small, black hat.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, click the icon to open the search bar and options filter.

4. Adjust which variants display in one or both of the following methods:

• Type the name of the variant in the search bar.
• Click one of the available options and select an option value.

5. Optional: Remove a search term or filter to display more results using one of the following methods:

• To remove a search term, delete the text in the search bar.
• To remove a single option filter, click the option name, then click Clear.
• To remove all option filters, click Clear all.

Filter by location

By default, the available quantity for all locations displays in the Variants section. You can filter by location to display available quantities for a specific location. You can edit available inventory after you filter by location. Click All locations to display the total available inventory for all locations.

Steps:

1. From your Shopify admin, go to Products.

2. Click the product that you want to edit.

3. In the Variants section, click All locations.

4. Select the location you want to review or update.

Group by option

Variants are grouped by variant option, and display the total number of variants within the group. To display or manage the variants within a group, click the top level variant to toggle open the group and edit individual variants within in the group.

If you have more than one variant option, then you can change the way variants are grouped by clicking one of the other variant options under Group by in the Variants section of the product details page. By default, if there's more than one option, then variants are grouped by the first option assigned. To change the default group, you can change the display order of variant options.