Articles on: Shopify

Barcode Field

Assign multiple barcodes (such as EAN, GTIN, UPC, ISBN, ASIN, or NS_PID) to your product variants on Shopify using feed columns or static fixed values. This ensures accurate product identification across your store inventory, marketplaces, and connected sales channels.


Available on: ✔️ Add | ✔️ Update | ✔️ Export



Watch the Barcode Field Walkthrough


Learn how to map product barcodes or set a default fixed barcode value across your product catalog.




How to Set Up Barcode Mapping


Go to App → Feed Settings → Step 2: Matching Column



  1. Open Barcode Settings: Select the Barcode field in Stock Sync.
  2. Smart Settings: Click on smart settings to add multiple barcode.
  3. Add Barcode Entry: Click + Add barcode to create a barcode mapping block.
  4. Select Barcode Type: Choose the specific identifier type from the Type dropdown (ASIN, EAN, GTIN, ISBN, NS_PID, UPC or enter as custom).
  5. Map Source or Static Value: In the Mapping field, select your feed file's column header or enter a static fixed value.
  6. Add Additional Barcodes (Optional): Click + Add barcode again to map multiple barcode types to the same product variant.
  7. Save Settings: Save your mapping configuration to apply barcodes during your next feed sync.


You can map multiple barcode types (such as both EAN and GTIN) within a single feed by clicking + Add barcode for each identifier.



Barcode Field Smart Settings / Detailed Breakdown


1. Multi-Barcode Mapping by Type

Instead of a single generic barcode field, Stock Sync allows you to map multiple barcode entries simultaneously, each assigned to a specific standard identifier type.


Supported Type options: ASIN, EAN, GTIN, ISBN, NS_PID, UPC and custom.


Example: You can map columns such as ean_code to Type: EAN and gtin_number to Type: GTIN. A custom column can also be mapped by manually typing it in the same feed.


2. Dynamic Column Mapping

Map the Mapping input directly to the corresponding column header name or column index in your feed file to import unique barcodes for each variant.


Ensure your feed file contains clean identifier strings matching the selected barcode Type.


3. Static Fixed Value

If your feed file does not have a dedicated barcode column, enter a static fixed value in the Mapping field to apply the same barcode uniformly across all mapped items.


Example: Setting Type to UPC and Mapping to a fixed value of 69076746472 assigns this exact barcode string to every product variant in the feed.



Key Rules & Technical Details


  • Shopify 5-Level Data Limit: Shopify currently enforces a maximum limit of 5 data levels per feed operation. By default, mandatory product and variant fields already consume 2 levels.
  • How Data Levels Are Counted: Mapping additional fields within the same level does not increase your level count, while adding a new resource category adds 1 level:


Data Level Category

Included Fields

Level Impact

Product Level (Default)

handle, title, description, vendor, product_type, seo.title, seo.description, status, template_suffix, brand, published, category, tags

Included in base 2 levels

Variant Level (Default)

price, compare_price_at, policy, taxable, option1, option2, option3, price_region, compare_price_at_region, quantity, quantity_incoming, quantity_quality_control, quantity_reserved, quantity_safety_stock, quantity_damaged, sku, cost, country_code_of_origin, harmonized_system_code, inventory_management, requires_shipping, weight, track_quantity

Included in base 2 levels

Media Level

images, video_links (Mapping both images and videos counts as 1 combined level)

+1 Level

Product Metafield Level

metafield (Product-level metafields)

+1 Level

Variant Metafield Level

metafields (Variant-level metafields)

+1 Level

Barcode Level

barcode (Supports multiple barcode entries within this single level)

+1 Level

Inventory Level

bulk_quantity, quantities (Multi-location inventory quantities)

+1 Level


Important: Because Product and Variant fields use 2 levels by default, if your feed already maps Media (Level 3) and Product Metafields (Level 4), you can only choose one remaining category for Level 5: Barcode, Variant Metafields, or Multi-Location Inventory.


  • Static Value Override: When a barcode entry is set to a static fixed value, every variant processed by the feed receives that exact specified barcode value for the selected Type.



Troubleshooting Steps


  • Issue: Unable to add the Barcode field or receiving a maximum level limit error → Solution: Check how many Shopify data levels your feed is currently using. If you already have Media, Product Metafields, and Variant Metafields (or Multi-Location Quantity) mapped, you have reached Shopify's 5-level maximum and must remove one of those levels before mapping Barcode.
  • Issue: Barcodes are not updating on Shopify → Solution: Confirm that you clicked + Add barcode, selected the proper Type (EAN, GTIN, UPC, etc.), and mapped the correct column name, column index, or static value in Step 2: Matching Column.
  • Issue: Barcode update fails due to invalid characters → Solution: Remove special characters, spaces, or symbols from your feed file or static fixed value field.



Good Articles to Continue


Updated on: 18/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!