Blog/Multiple Barcodes per Variant on Shopify: Setup for Wholesale and POS
UpdatesNovember 18, 2026 | 17 min read

Multiple Barcodes per Variant on Shopify: Setup for Wholesale and POS

One variant, one barcode is over. Shopify now stores up to 20 codes per variant, but sales channels still read only the first, so the order you enter them in matters.

By Syeda Rehnoma Tanzom

A Shopify variant for a 12 oz Sage mug holding four barcodes, with the main GTIN first and marked as the code sales channels read, plus supplier EAN, old-packaging UPC and a custom warehouse code

Share this post

A kitchenware distributor buys the same 12 oz mug in Sage from two factories. The first factory's cartons carry the barcode that's in Shopify. The second factory's cartons carry a different EAN. When the second shipment arrives, the receiving team scans a box and Shopify finds nothing, so someone types the SKU by hand and adds another row to the spreadsheet titled "their code, our code".

Until this fall, that spreadsheet was the normal fix. A Shopify variant could hold one barcode, so supplier codes, case codes, old packaging codes and retailers' own item numbers all lived somewhere else. That costs time at receiving and at the register, and it adds risk, because barcodes are scanned over 10 billion times a day and every system on the other end expects the code on the box to match a record.

Shopify multiple barcodes change that. Since September 2026, one variant can carry up to 20 codes, and Shopify POS can find the variant by any of them. This guide covers the barcode types and format checks, which code has to go first, the four ways to add codes (including the exact CSV syntax), how POS uses them, the wholesale situations they solve, and what they still don't do.

Short answer: Yes. Since September 8, 2026, a Shopify variant can have up to 20 barcodes, each with a type: UPC, EAN, ISBN, GTIN, ASIN or Custom. You can add them on the variant page, in the Shopify mobile app, in the bulk editor or through the product CSV, and Shopify POS finds the variant when any of them is scanned. Sales channels read only the first barcode, so put the item's main GTIN first.

TL;DR

  • Each Shopify variant can now store up to 20 barcodes, and any of them identifies the variant in the admin and in Shopify POS.

  • Standard types (UPC, EAN, ISBN, GTIN, ASIN) are checked against their format. Internal codes and retailer item numbers need the Custom type.

  • Sales channels, labels and many apps read only the first barcode, so the main GTIN must be first.

  • You can add codes on the variant page, in the mobile app, in the bulk editor, or in bulk with the Barcodes column of the product CSV.

  • A barcode doesn't store a quantity. Scanning a case code on a unit variant finds the unit, so sell cases as their own variant.

  • Test a small batch first: import, check the order of codes, scan at POS, and confirm your feeds and apps still read the right code.

Can a Shopify Variant Have More Than One Barcode?

Yes. Shopify's changelog announced on September 8, 2026 that product variants now support multiple barcodes: up to 20 per variant, or per product if it has no variants. Each barcode has a type, and any of them identifies the item when it's scanned or searched in the admin or in POS.

Before this, the rule was one Shopify barcode per variant, and merchants worked around it in a few ways. Some kept alternate codes in a spreadsheet or a metafield, which POS couldn't scan. Some created duplicate variants for each supplier's code, which split inventory across two records for one physical item. Some typed two codes into one field with a slash between them, which broke every scan.

Your existing barcodes didn't need any migration. The barcode each variant already had became the first in its list, and Shopify keeps using the first barcode wherever a single barcode is expected, so labels and feeds kept working.

Barcode Types and Format Checks

Every barcode you add gets a type. For standard types, Shopify checks the value against that standard's format and flags errors as you enter them. Custom is the default and accepts any value, which is why internal codes have to use it.

Type

Accepted format

Use it for

GTIN

8, 12, 13 or 14 digits

The global trade item number registered for the item, including 14-digit case codes

UPC

8 or 12 digits

Consumer products labeled for North America

EAN

8 or 13 digits

Consumer products labeled outside North America

ISBN

10 or 13 characters, may include X

Book editions

ASIN

10 letters or digits

Amazon's catalog number for the item

Custom

Any value up to 255 characters

Internal codes, warehouse labels (Code 39, Code 128), retailers' item numbers

These formats come from Shopify's Help Center page on barcodes. UPC, EAN and ISBN are all kinds of GTIN, so you'll often see the same item described both ways. The Help Center also lists an NS-PID type, a manufacturer identifier used on EU customs declarations.

Two details save time. If you enter a code that's registered with GS1, Shopify sets the type to GTIN for you and warns you if the product name or vendor doesn't match the GS1 record. And if you saved a Custom code that turns out to be a valid GTIN, Shopify suggests changing its type, which you can accept or dismiss.

Use Custom for anything that isn't a standard code: your internal item numbers, a 3PL's bin label, or a retailer's own SKU for your product. A standard type will reject those values, and that's the format check doing its job.

The Catch: Sales Channels Read Only the First Barcode

This is the rule that decides whether multiple barcodes help you or hurt you. Shopify's changelog states that sales channels read only the first barcode. The first barcode is also the one used wherever a single barcode is expected, such as labels and many apps.

So on your Shopify variants, the first position should always hold the item's main GTIN: the code registered for that exact item, in the form your channels expect. If a supplier's alternate EAN or your Custom warehouse code ends up first, that's the code your channel feeds send out.

The stakes are real. In GS1 UK's coverage of Google's GTIN changes, Google says providing the correct GTIN can increase a product's conversion rate by up to 20%. A wrong or mismatched first barcode can do the opposite.

Apps need a check too. Shopify's developer changelog for the new barcodes field says the old single barcode field still works but returns only the first code, and integrations that read only that field silently miss the others. If an app syncs your codes to an ERP, a marketplace, a 3PL or a supplier feed, ask the vendor whether it reads the full list or only the first barcode.

After any change, open a few variants or export a few products and confirm the main GTIN is still first. It takes two minutes and catches the most expensive mistake.

How to Add Multiple Barcodes to a Variant in Shopify

You can add barcodes in four places. The layout of Shopify's new variant editor changes where some fields sit, but the barcode steps are the same in each place.

On the variant page (desktop)

  1. In the Shopify admin, go to Products and open the product.

  2. In the Variants section, select the variants you want to change, then choose Edit barcodes from the menu.

  3. For each variant, enter a barcode and pick its type from the drop-down (Custom is the default).

  4. Click Add barcode to add another code, up to 20.

  5. Click Done, then Save.

For a product without variants, the Barcodes field is in the product's Inventory section and works the same way.

You can also open a single variant and edit its codes there. In the new editor, the Barcodes field sits next to the SKU field, shows the first code with a count of the rest, and opens into the full list with a type for each code.

Shopify variant page for an 8 oz Amber Glass jar candle with SKU CNDL-08-AMB and four barcodes: a GTIN listed first, then an EAN, a UPC and a Custom warehouse code

In this example, the GTIN is first because it's the code sales channels will read. The supplier's EAN, the old packaging UPC and the internal warehouse label follow it.

In the Shopify mobile app

Open the product, select a variant, and tap Edit in the inventory section. Tap the barcode icon to scan a code with your phone's camera, set its type, add more if you need them, and save. This is the quickest way to capture a new supplier's code when the carton is in front of you.

In the bulk editor

The bulk editor lets you update barcodes across many variants at once, and Shopify's Help Center notes you can enter them with a barcode scanner. It suits a receiving session where you scan each new carton straight into the right variant row.

With a product CSV

For hundreds of variants, the product CSV is the practical route. Shopify's product CSV guide describes the format:

  • All of a variant's codes go in one Barcodes column, up to 20 per variant. (Shopify's changelog calls it the Variant Barcodes column.)

  • Separate codes with a semicolon.

  • To set a type, write the type and a colon before the value. A code without a type imports as Custom.

  • If a value contains a backslash, semicolon or colon, escape it as \\, \; or \:.

  • The old single Barcode column is replaced by Barcodes on export. A file that has both columns fails to import.

Here's the Barcodes cell for the Sage mug, with the main GTIN listed first:

gtin:5012345678900; ean:5098765432100; upc:840123450128; MUG-SAGE-12-WH

The last value has no type, so it imports as Custom. Before you edit anything, export the products you plan to change and work from that file. That way you start from the current codes and the current column names.

Which Barcodes to Add: Wholesale and Multi-Supplier Use Cases

Multiple barcodes solve a specific problem: one physical item, several codes in the real world. Here's how that looks in a wholesale or multi-supplier store.

Situation

What to add

Type

What goes first

Same item from two suppliers

Each supplier's code

GTIN or EAN

Your main GTIN for the item

Old and new packaging on the shelf

Both packaging codes

GTIN, UPC or EAN

The code on current packaging

A retailer orders by their own item number

The retailer's number

Custom

Your main GTIN

Internal or warehouse labels

Your internal code

Custom

Your main GTIN

The item is also sold on Amazon

The ASIN

ASIN

Your main GTIN

A sealed case of 12

Don't add to the unit variant

GTIN (14 digits)

Goes on a separate case variant

Supplier codes for the same item

When you buy one item from more than one supplier, each may print its own code on the carton. Adding every supplier's code to the variant means receiving staff can scan whatever arrives, and stock lands on the same variant instead of a duplicate. This matters most during busy restocks, when Q4 wholesale replenishment brings in mixed shipments from several sources at once.

Case vs unit barcodes

This is where wholesale stores most often go wrong. A barcode in Shopify doesn't store a quantity. If you add a 14-digit case code to the unit variant, scanning the case at POS or at receiving finds the unit variant, and you get one unit, not twelve.

If you sell or receive full cases, create a case variant (for example, "Case of 12") and give it the case GTIN. Keep the unit's code on the unit variant. If you only receive cases but sell units, count the units as you receive them, or use a receiving tool that converts case scans into unit counts.

Old and new packaging

When a supplier changes packaging, the barcode often changes too, but old stock still sits on the shelf for weeks. Add the new code to the same variant so both scan to one record. Once the new code is on everything you sell, move it into the first position. When the old stock is gone, remove the old code so it can't confuse a future feed.

Wholesale buyer item numbers

Some retailers order using their own item numbers, and their purchase orders list those numbers rather than yours. Adding a buyer's number as a Custom barcode lets your team search for it in the admin and scan it at POS. The same item numbers belong on the wholesale line sheet you send that buyer, so both sides refer to one record.

Marketplace codes

If you also sell on Amazon, add the ASIN as an ASIN-type barcode so your team can look the item up by it. Keep it out of the first position, since your other channels expect a GTIN there.

How Shopify Multiple Barcodes Work in POS

Shopify POS can scan and search variants by any of their barcodes, and by the SKU. That works at checkout, when receiving stock and during inventory counts. It's available from Shopify POS v11.14, and the extra codes have to be added to the variant in the Shopify admin first.

For a retail counter, that means a customer can bring any version of the packaging and the cashier gets the right variant on the first scan. For a back room, it means a new supplier's carton can be received without a lookup.

Before you rely on it, scan a sample: one item with each kind of code you added, from both old and new packaging if you have them. Then tell staff the one rule that trips people up, which is that a case code on a unit variant rings up one unit.

A Rollout Plan for Shopify Variant Barcodes

A careful rollout takes an afternoon for most catalogs. The order below keeps your feeds safe while you add codes.

  1. Export your products. Work from the current CSV so you see every variant's existing barcode.

  2. Choose the main code for each variant. It should be the GTIN registered for that exact item. Mark any variant that has no GTIN; if you make the product yourself, you'd get one from GS1.

  3. Collect the alternate codes. Ask suppliers for their carton codes, pull retailers' item numbers from their purchase orders, and list your own internal codes.

  4. Decide each code's type. Standard codes get their standard type. Everything else is Custom.

  5. Import a test batch of about ten products. Include a few variants with several codes and one with a code that needs escaping.

  6. Check the order. Open those variants or export them again and confirm the main GTIN is first.

  7. Scan at POS. Scan each kind of code and confirm it finds the right variant.

  8. Check your feeds and apps. Confirm your channels still show the right GTIN, and ask the vendors of any syncing apps whether they read the full list.

  9. Import the rest of the catalog. Keep a note of where each code came from (supplier, retailer, internal), so whoever removes an old code later knows what it was for.

What Multiple Barcodes Don't Do

Multiple barcodes fix the "several codes, one item" problem. They don't change how Shopify handles quantities, channels or apps. Here are the limits to plan around.

Limit

What it means for you

No pack quantity

A case code on a unit variant scans as one unit. Use a separate case variant.

Channels read only the first barcode

Order matters. The main GTIN must be first.

Apps reading the old field see one code

Integrations that read the deprecated barcode field miss codes 2 to 20.

API updates replace the whole list

An app that sends a new list overwrites the old one, so it has to include every code you want to keep.

No duplicates on one item

The same value can't be added twice to the same product or variant.

20 codes, 255 characters each

Enough for most items, but not a place to store every code that has ever existed.

Shopify doesn't issue GTINs

Registered GTINs come from GS1. Shopify stores and checks them.

Two of these are worth a second look. The quantity point affects anyone who sells in packs, and the app point affects anyone with an ERP or marketplace sync. For a storefront, these codes are mainly for your team: customers ordering online see the product and its variants, not the list of alternate barcodes.

Where MultiVariants Fits Once the Catalog Is Clean

Clean barcodes make the back office faster. Wholesale buyers still have to order from your storefront, though, and with variant-heavy products that's where many orders slow down. A buyer restocking 12 colors in four sizes has to pick each variant from a drop-down and add it to the cart one at a time, which is why buyers struggle to order many variants on a standard product page.

MultiVariants is one way to fix the storefront side. It shows every variant of a product in one table, list, grid or matrix with a quantity box for each, and buyers add all of them to the cart with one click. You can also set minimums, case-pack steps and per-variant limits, which supports B2B bulk ordering from the product page to checkout.

It can also show each variant's SKU and barcode details in the table. That helps a buyer match each line to their own purchase order, and it helps when they reorder only the variants that sold last month.

Here's what it doesn't do. The extra barcodes you store in Shopify (codes 2 to 20) aren't shown in the MultiVariants table, and buyers can't search the table by them. Scanning and searching by any barcode is a Shopify POS and admin feature. If your buyers rely on their own item numbers, put those numbers on the line sheet or in the product's details as well.

MultiVariants on the Shopify App Store has a free plan, and paid plans start at $12.99 a month with a 14-day free trial.

Conclusion

Shopify multiple barcodes finally let one variant carry every code it's known by: supplier codes, old and new packaging, retailer item numbers and internal labels, up to 20 in total. POS can find the variant by any of them, which ends most of the "their code, our code" spreadsheets.

The rule to remember is that channels read only the first barcode, so the main GTIN always goes first. Give cases their own variant, use Custom for codes that aren't standard, and test a small batch before you import the whole catalog.

Can a Shopify variant have more than one barcode?
Yes. Since September 2026, each Shopify variant can have up to 20 barcodes, and each one has a type: UPC, EAN, ISBN, GTIN, ASIN or Custom. Any of the codes identifies the variant in the Shopify admin and in Shopify POS. Sales channels still read only the first barcode, so put the main GTIN first.
How many barcodes can a Shopify product have?
Up to 20 per variant, or up to 20 on a product that has no variants. Each barcode can be up to 255 characters long. A product with many variants can hold up to 20 codes on each variant, and the same value can't be added twice to the same product or variant.
Which barcode does Google Shopping use if a variant has several?
Sales channels read only the first barcode in the variant's list. That's the code your channel feeds send, so the first position should hold the GTIN registered for that exact item. After an import or bulk edit, check a few variants to confirm the main GTIN is still first.
Does Shopify POS scan secondary barcodes?
Yes. From Shopify POS v11.14, POS finds a variant by any of its barcodes or by its SKU, at checkout, during receiving and during inventory counts. The extra codes must be added to the variant in the Shopify admin first. Scan a few test items after you add them.
How do I import multiple barcodes with a CSV?
Put all of a variant's codes in the Barcodes column, separated by semicolons. Add a type before each value with a colon, like gtin:5012345678900; upc:840123450128. Codes without a type import as Custom. A file can't contain both the old Barcode column and the new Barcodes column, so export first and edit that file.
Can two variants share the same barcode?
Shopify blocks adding the same value twice to one product or variant, and the standard practice is to give each variant its own unique barcode. If two variants really are the same physical item, it's usually better to merge them into one variant and store both codes on it.
What barcode type should I use for internal codes?
Use Custom. It accepts any value up to 255 characters, including warehouse labels such as Code 39 or Code 128 and retailers' own item numbers. Standard types like UPC and EAN check the format and will reject values that don't follow it.
If I scan a case barcode, does POS sell a whole case?
No. A barcode in Shopify doesn't store a quantity, so a case code added to a unit variant finds the unit and adds one. If you sell full cases, create a case variant, such as "Case of 12", and give it the case GTIN.

Reviewed by

This article was reviewed by the MultiVariants Technical Support Team, who regularly helps Shopify merchants test bulk ordering setup, variant selection, quantity rules, cart behavior, and checkout validation issues.

About the Author

Syeda Rehnoma Tanzom

Syeda Rehnoma Tanzom

MultiVariants Contributor

This article is written by Syeda Rehnoma Tanzom, an SEO content writer with 3+ years of experience specializing in eCommerce content. What makes the work here a little different? A close collaboration with support teams to understand what merchants are actually going through, their frustrations, their questions, and their wins. The goal is simple: write content that speaks to real problems, not just search engines. When not buried in keywords and content briefs, you'll find her nose-deep in a good book, binge-watching true crime documentaries or psychological thrillers, and occasionally switching gears with a feel-good rom-com.

Find it on the Shopify App Store