Skip to content

Shopify Dude Fix

Why Did Shopify Duplicate My Product Barcode?

A Shopify POS and inventory troubleshooting guide for duplicate product barcodes, including product duplication settings, Retail Barcode Labels, CSV cleanup, and POS testing.

Quick answer

Shopify barcodes are stored on variants, not just products. Duplicate barcodes usually come from duplicating a product or variant with the barcode copied, importing a CSV with repeated values, or using barcode generation workflows without checking uniqueness. Shopify’s Retail Barcode Labels app can also rarely generate the same Code-128 value because of how it derives the barcode from the variant ID.

Fix Radar

Difficulty: ★★☆☆☆
Time to diagnose: 10–20 minutes
Usually caused by: duplicated product data, CSV imports, POS barcode workflows, or variant-level barcode cleanup.

The real symptom

Scanning a barcode in Shopify POS returns multiple products, the wrong product, or a duplicate-barcode warning. In admin, two unrelated variants may share the same barcode. This is especially painful for stores that receive inventory quickly, print labels in bulk, or duplicate products as a normal merchandising workflow.

Why this happens

The barcode field lives at the variant level. When a product is duplicated, imported, or bulk edited, variant fields can come along for the ride. That is useful for titles, descriptions, or option structures, but dangerous for identifiers. A barcode should identify one sellable unit. If it is copied, the POS scanner can no longer know which item was intended.

Most likely causes

  1. A product was duplicated and the barcode was copied. Community threads report this exact behavior and request safer defaults.
  2. A CSV import reused existing barcode values. This happens when a spreadsheet is copied from old products and only titles/prices are changed.
  3. Variants were duplicated in bulk. Barcode values can be duplicated across variants if not cleared.
  4. The Retail Barcode Labels app generated a rare collision. Shopify documents that the app uses the last eight digits of the variant ID for Code-128 barcodes, which can rarely collide.
  5. External inventory or POS software wrote duplicate barcode values back to Shopify.

Confirmed Community fix

Community reports show two durable versions of the issue: product duplication copying barcode values, and Shopify/POS users discovering duplicate barcode values only when scanning. The practical fix is not theme-related: audit variant barcodes, clear or replace duplicates, and adjust the team’s duplication/import workflow so identifiers are not copied blindly.

Exact admin path

Edit one barcode: Shopify admin → Products → open product → open variant → Inventory → Barcode.

Bulk review: Products → Export → open CSV → sort the Barcode column → identify duplicates.

POS test: Shopify POS → scan barcode → confirm only one product/variant is returned.

Retail Barcode Labels: Apps → Retail Barcode Labels → review generated labels and replace any duplicate barcode values manually.

CSV cleanup check

Export products and sort the barcode column. Any repeated non-empty barcode value should be reviewed.

Handle,Title,Option1 Value,Variant SKU,Variant Barcode
black-shirt,Black Shirt,S,BLACK-S,12345678
navy-shirt,Navy Shirt,S,NAVY-S,12345678  <-- duplicate

Operational fix

  1. Stop duplicating products with identifiers copied unless the duplicate is a true replacement record.
  2. When duplicating a product as a template, clear variant barcode values before saving or before import.
  3. Use a barcode source of truth if barcodes are assigned outside Shopify.
  4. Run a monthly duplicate-barcode export check for POS-heavy catalogs.

DevTools/Liquid check

This is mostly an admin/POS data problem, not a theme problem. Liquid can display the current variant barcode, but it cannot make duplicate barcodes safe.

{{ product.selected_or_first_available_variant.barcode }}

Before you edit code

Do not touch the theme. Duplicate barcodes are product data. Fix the barcode values in Shopify admin, CSV, POS, or the external system that owns identifiers.

Do not do this

  • Do not use the same barcode for multiple sellable variants unless your POS/inventory workflow explicitly supports it.
  • Do not assume SKU uniqueness solves barcode duplication. SKU and barcode are separate fields.
  • Do not print another batch of labels until the duplicate values are cleaned.

How to test the fix

  • Scan the corrected barcode in Shopify POS.
  • Search the exported product CSV for the old barcode value.
  • Confirm only one active variant has that barcode.
  • Reprint the affected labels.
  • Test receiving inventory and checkout with the corrected label.