Shopify Product Variants: How to Add and Manage Them

Shopify builds variants out of options. You name the ways a product varies — size, color, material — enter the values, and every combination becomes a variant that carries its own price, SKU, stock and image.

This guide walks through adding and editing variants in the admin, the bulk editor and a CSV file, finding a variant ID, and what to do when three options or the variant ceiling stop fitting your product.

How Do Options Become Variants in Shopify?

Shopify describes variants as a way to offer different versions of a product, such as sizes and colors, so customers can find exactly what they want. The definition is worth reading word for word, because everything else on this page follows from it:

Multiply the values to see where a product is heading. Shopify's SKU guide uses a shirt sold in 3 sizes and 4 colors: 3 × 4 = 12 variants, and because each product and variant must have its own unique SKU, 12 different SKUs.

Every value multiplies rather than adds. Give that same shirt a third option with two materials and it becomes 24 variants. The options themselves are set per product, so a mug can vary by size alone while the shirt varies by size and color. Before the count passes 100, check the variant limits below.

How to Add Variants to a Shopify Product

Variants live on the product details page, in a section of their own. The steps below follow the desktop admin; in the mobile app the same button reads + Add options like color, size, etc.

Add options and values to a new product

If you want a color option shown as swatches, set the product's category first and build that option from its category metafield, as the swatches section below explains.

1. In your Shopify admin, go to Products and open the product.
2. In the Variants section, click + Add options like size or color.
3. Enter the option name, such as Size, and its values, such as Small, Medium and Large. Add a second or third option the same way.
4. Save, then review the variant list: Shopify has turned the values into variant combinations.
5. Open each variant to set its Price, Inventory and Shipping. Once a product has variants, those settings are adjusted for each variant from the variant details page, not from the product details page.

Add a value or a single variant to an existing product

Adding a value is the fast route. Give the 12-variant shirt a fifth color and Shopify creates its three size combinations in one step, because a new value quickly generates the multiple new variant combinations.

Adding a variant by hand, or duplicating one, creates only a single variant — the right tool when one combination is missing. You can't save an exact duplicate of a variant that already exists, and when you duplicate in bulk, a variant that already exists isn't copied a second time.

In both routes you can give the new variants their own images, prices, quantities, SKUs, barcodes, HS codes, country/region of origin and locations, or use the defaults based on the product details.

A new option works differently from a new value. To add one, click + Add another option and enter the option name and a default option value, which the variants you already have take on.

If you prefer to watch it on screen, Professor Commerce's 2024 walk-through has chapters on adding and editing variants, variant images, variant prices and the variant picker. It was recorded in the 2024 admin, before the October 2025 limit change, so use it for the layout of the screens and take the current limits from the section on limits below.

What Each Variant Can Have of Its Own

The first thing that changes when you add variants is where the settings live. On a product without variants, price, inventory and shipping sit on the product details page; once variants exist, each variant holds its own, edited from its own details page.

Two codes on one variant are fine as long as they differ. Whether two different variants may share one barcode is a separate question, answered in can two Shopify variants share the same barcode.

Stock is counted per variant and per location, so a store selling from more than one place sets each variant's quantity at each location. How Shopify routes those counts between locations is covered in our multi-location inventory guide.

Variant images: one image per variant

Upload images to the product first, then assign them. A product can have up to 250 media items, such as images, and each variant can have one media item applied, which must be from the product's media list.

The media type is restricted too: product variants don't support other types of media, such as 3D models or videos, and you can only add one image to each product variant. For a second or third photo of the same color, Shopify's answer is the product's media gallery, which can display additional images for a variant option.

How the 250-item ceiling plays out across a wide color range is worked through in how many images and media files one Shopify product can have.

How to Edit, Reorder and Remove Variants

You can add, remove, or edit variant options and option values from the product's Variants section on desktop, or its Options section in the mobile app. Which tool to reach for depends on how many variants the change touches.

Rename options and change their order

Order matters because shoppers see it: variant options and values display to customers in a particular order, and Shopify's editing guide lets you set that order yourself. Put the option a shopper decides on first at the top.

• Rename an option: click Edit next to the option, then enter the new option name.
• Reorder options: use the drag-and-drop handles ⋮⋮ next to each option.
• Reorder values: click Edit next to the option, then drag the values by their ⋮⋮ handles.
• Remove a value: delete it from the option — unless it is the only value listed, in which case you delete the option entirely.

Edit many variants at once

Small changes don't need a separate tool: you can change some variant details, such as the image, price and the quantity at a location, from the product details page itself. For more, the bulk editor makes changes to all details for multiple variants at one time.

The bulk editor lays the variants out as a table in which each column is a property — price, SKU, compare-at price. One exception catches people out: when a product has multiple variants, you can only bulk edit its inventory from the Inventory section of the admin.

Unpublish a variant instead of deleting it

Shopify's own advice is to manage publishing rather than delete when you want to stop selling a variant but keep it in your admin for historical data or to republish at a later date. What deleting does to past orders and reports is answered in what happens to order data when you delete a Shopify variant.

Publishing variants works per sales channel and per catalog, with three rules to keep in mind:

• A variant appears in a sales channel or catalog only when both the parent product and the variant are published to it.
• If every variant of a product is unpublished from a channel or catalog, the whole product is hidden there until you republish at least one variant.
• You can't set a publishing date for an individual variant.

To delete one variant, click it in the product's Variants section, then click Delete variant and click Delete variant again. To delete multiple variants at one time, use a bulk action.

Retiring the variants altogether is a different move. If you no longer want to sell a product with variants, 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.

Importing Variants by CSV Without Losing Data

A product CSV file is the tool for a catalog-wide change, and it follows the same rule as the admin: a product can have up to 3 options. To import a brand-new product, Title is the only required column unless you're adding variants for it, when the URL handle column is required too. The risk sits in files that update products which already have variants.

One more gap: variant metafields aren't supported for product CSV import or export, so values stored there don't move with the file.

The daily upload limit for very large catalogs

Volume only matters at the very top end. If your store already holds 500,000 or more variants, uploads through an app or CSV import are subject to a daily rate limit: you can add up to 10,000 new variants in a day before the limit is reached, so a bigger import runs over several days. On the Shopify Plus plan the daily rate limit doesn't apply.

Category Metafields as Options and Color Swatches

Instead of typing a free-text option, you can use category metafields to create variant options. The payoff is visual: when you use color entries as variant options, you can display them as swatches for color options on your storefront product pages.

The theme decides whether those swatches appear. To complete Shopify's category-metafield setup you need a theme that supports variant options with swatches; a vintage theme needs code changes or a Shopify Partner. For Dawn, Shopify specifies the latest version. Whatever theme you run, check its documentation for swatch support before converting your options.

The category itself has one boundary to plan around: a product can have only one product category, and it applies to all its variants, as Shopify's product details page states.

Category metafields are one kind of Shopify metafield. How metafields and metaobjects hold the rest of your product data is covered in our Shopify metafields guide.

Amine Ammari's short 2024 video shows the category-metafield swatch setup on screen. It is a third-party walk-through whose description links a swatch guide for Dawn, so confirm that your own theme supports swatches before following it.

How to Find a Shopify Variant ID

1. In your Shopify admin, go to Products and open the product.
2. In the Variants section, click the variant.
3. Look at the browser address bar: the number after /variants/ is the variant ID.

A product that has no variants still has a variant ID assigned to it, but it isn't displayed in the address bar; Shopify's variant ID guide gives a separate method for that case.

For many IDs at once, go to Analytics: the Product variant ID dimension is available in custom data explorations, under Analytics > Reports > New exploration.

Shopify names two reasons a merchant needs the number: theme code customizations that target specific variants, and reconciling migration or bulk product update information with a third-party app. Because rewriting option values by CSV gives variants new IDs, collect the IDs after an import, not before.

The ID identifies the variant in your admin. How a variant is addressed on the storefront is a separate question, answered in does a Shopify product variant get its own URL handle.

Shopify Variant Limits: 2,048 Variants, 3 Options and the 100 Line

Two ceilings are hard and one is practical. A product can carry up to 2,048 variants and up to three options, on every plan; the 100-variant line is where parts of your stack may stop following.

Two numbers exist because the ceiling moved. On October 15, 2025, Shopify raised the per-product ceiling from 100 to 2,048 for all merchants. Themes, apps and channels built around the old number did not all move with it, and Shopify's developer changelog said so plainly:

So the practical test comes before the product, not after. If a product will pass 100 variants, check your theme, every app that touches products and every sales channel you publish to; a theme customization that loops over all variants has its own line at 250.

When Native Variants Aren't Enough

Native variants fit when the product varies along three axes or fewer and every combination is something you stock. When it doesn't, Shopify's own note names the exits: to create a product with more than 2,048 variants or more than three options, you can use a third-party app from the Shopify App Store, or customize your theme code to extract line item properties. Find your product's row:

Bundles carry rules of their own beyond those two numbers; which bundle setup fits is compared in native versus paid bundle apps.

Selling wholesale through B2B catalogs raises one more variant question, and whether quantity rules count across variants has its own answer.

Combined Listings: separate products shown as variants

A combined listing is a product type created by connecting separate products from your store into a single product listing. On the storefront the products display as variants, but each can carry details not usually available at the variant level — a title, description, unique URL or image gallery.

The Shopify Combined Listings app is available only on Plus and enterprise commerce plans. Its boundaries:

• Up to 60 products per listing, and a product can be in only one combined listing at a time.
• By default, up to 2,048 variants across all child products, and up to 3 options in addition to the options in each product.
• Displays on free Shopify themes in version 15.0.0 or later; other themes may need code changes.
• Can't be added to a product bundle or sold as a subscription product.
• When you filter product options with the Shopify Search & Discovery app, child products aren't included in the filter results.

Setup steps and the options below Plus are in our Shopify Combined Listings guide.

Whether each child product keeps a page of its own is answered in does a combined listing child product keep its own page.

Line item properties: custom input without new variants

Line item properties consist of a name and value pair, and Shopify's product template documentation describes them as the way to let customers customize orders or provide supplementary information for a variant they add to the cart.

They are not variants: nothing new appears in your variant list. And if two of the same item go into the cart with unique properties, the cart documentation says they are split into separate line items.

What they do to price is the part to check before relying on them. As of October 7, 2026, none of the Shopify pages we read — the Adding variants, Editing variants, Variants and product details pages in the Help Center, and the product template, cart template and line_item references on shopify.dev — states whether line item properties change the price of a cart line.

Price changes are described separately, in the reference for Cart Transform functions: its example reads a cart line attribute to add a priced gift-wrap add-on through an expand operation, while update operations, which override a line's price, are available only to development stores and Shopify Plus stores through apps.

Options apps: more choices, not more variants

Shopify's note on going past its variant and option ceilings names a third-party app from the Shopify App Store as one route. What such an app adds is choices, not variants — and one vendor says so outright. ShopPad, which makes Infinite Options, documents the mechanism.

According to ShopPad's documentation, apps like Infinite Options let you create unlimited options such as checkboxes, radio buttons, text fields, swatches and drop-down menus, but 3rd party apps cannot create Shopify variants, and its options do not track or affect inventory. The same page still describes Shopify's old 100-variant limit, so take the mechanism from it, not the number.

Stock can be brought back for a single choice: the app's inventory guide says you can track an option selection by linking its price with a Shopify product, and that inventory is then controlled by Shopify. The side effect it warns about: a main product can show as Sold out while it has stock, and the likely cause is a linked add-on product that is out of stock.

Which class of options or configurator app fits a product, and what each costs, is compared in the configurator guide's app breakdown.

Variant Setup Checklist

Use this list on every new product with variants. Progress is saved in this browser, so you can stop mid-catalog and pick up where you left off.

The Bottom Line

The work is mostly in the order: options before fields, images from the product's media, and an unpublish wherever a delete would erase history.

Frequently Asked Questions