Variant-Aware Scan-to-Print for Shopify (Skip the Picker)
If scanning a Shopify variant barcode opens a picker instead of jumping to the right label, the fix is usually on the Shopify side, not the app. Here's how to set it up properly.
If your retail staff scans a barcode on a Shopify product variant and the label app pops open a picker asking which variant to use, the problem usually isn’t the app — it’s that the Shopify variant doesn’t have its own unique barcode. Once each variant has a unique code, Barcodeman’s Scan and Print feature goes straight from scan to label with no picker in the middle.
This guide explains why the picker appears, how to structure your Shopify data so scanning lands on the right variant, and the scan-to-print workflow that retail staff can actually use at speed.
Why scanning shows a variant picker
Shopify’s Barcode field lives on the variant, not the product. A product with three sizes (Small / Medium / Large) has three variants and therefore three separate barcode slots. The problem: many merchants fill in the product-level SKU and leave the variants’ barcode field blank, or copy the same barcode across every size.
When a label app scans a barcode and gets multiple matches — or finds the value on the product but not on any specific variant — it has no way to know which size you meant. The only safe behavior is to surface a picker and let the user choose.
The fix is on the Shopify side: give each variant its own unique barcode. Once you do, scanning unambiguously identifies one variant and the app can skip the picker entirely.
The Scan and Print workflow in Barcodeman
Barcodeman has a dedicated Scan and Print page designed for this exact workflow — scan, print, scan, print, at the speed of a retail counter.
- Open Barcodeman and find the Scan and Print card on the Home page (it’s not in the sidebar, only on the home view)
- Click into the barcode input field so it has keyboard focus
- Scan a variant’s barcode with a handheld scanner, type it manually, or paste it
- If the value matches exactly one variant, Barcodeman queues the label and is ready for the next scan
- When you’re done scanning, print the batch
Most USB and Bluetooth handheld scanners emulate keyboard input — they “type” the scanned code into whatever field has focus. That means most retail-grade scanners work with Barcodeman’s Scan and Print out of the box, with no special driver or app pairing. If your scanner has a configuration setting for “keyboard wedge” or “HID mode”, make sure it’s enabled.
For the full reference on the flow — including the “Not ready” state and scanner troubleshooting — see Scan and Print in the help center.
Making your variants scannable
If scanning currently shows a picker, run through the Shopify product list once and audit the barcode field on every variant.
Option 1: Assign real GS1 / UPC barcodes per variant
If you already have purchased GTINs (from GS1 or a supplier) or real UPC-A codes, paste the correct one into each variant’s barcode field. This is the right move for merchants who sell into Amazon, Walmart, or other GTIN-verifying channels.
Option 2: Generate internal barcodes per variant
For merchants who only need internal / in-store scanning, Barcodeman’s SKU generator can create unique codes for every variant in one pass. Each variant gets its own scannable Code 128 barcode without any GS1 registration.
See the SKU generator help article for the exact flow, and the barcode format guide for why Code 128 is the right default for internal codes.
Option 3: CSV import a barcode column
If you have barcodes in a spreadsheet, Shopify’s product CSV import accepts a Variant Barcode column. Fill it per variant row, upload the CSV, and Shopify applies the barcodes.
Whichever path you take, the test is the same: each variant ends up with a unique value in the barcode field. Once that’s true, Scan and Print jumps straight from scan to label.
Common scan-to-print gotchas
”Not ready” status
The scanner’s output has nowhere to go. Click into the barcode input on the Scan and Print page so it has keyboard focus, then scan again. Most scanners only “type” into the focused element, just like a keyboard.
Scan succeeds but finds no product
The scanned value doesn’t exist in any variant’s barcode or SKU field on Shopify. Either the variant wasn’t set up, or the barcode field has extra spaces / characters that don’t match. Copy the scanned value and paste it into Shopify’s product search to confirm which record it maps to.
Same barcode across variants still shows the picker
That’s the root cause covered above — not a bug, a data issue. Give each variant its own unique barcode.
iPhone / iPad camera scanning is unreliable
Phone cameras work for a few scans but aren’t designed for retail speed. For a POS counter or fulfillment station, use a USB or Bluetooth handheld scanner in keyboard wedge mode. Entry-level scanners are inexpensive and work instantly with Scan and Print.
Frequently asked questions
Do I have to use a handheld scanner?
No. The barcode input accepts typed or pasted values. A handheld scanner just makes retail-speed workflows practical — typing is fine for occasional scans.
Does a Bluetooth scanner work?
Yes, as long as it supports HID keyboard mode (most retail scanners do). Pair it to your computer or iPad the same way you’d pair a Bluetooth keyboard, then click into the barcode input before scanning.
Can I use the Shopify POS hardware scanner?
Yes — POS hardware scanners emit keyboard input, which is all Scan and Print needs. The only constraint is that the Barcodeman Scan and Print page must be the focused app / tab for the scan to land there.
Can I scan multiple items and then print them together?
Yes. Each successful scan queues one label. Scan through the batch, check the queue, then print once at the end. This is the typical pattern for reprinting after restock.
What’s the difference between scanning an SKU vs a barcode?
Barcodeman’s Scan and Print matches against both the variant’s SKU and its barcode fields. Either one works, as long as the scanned value is unique across your catalog.
How does this compare to just printing from the product list?
Scan and Print is for the single-item, in-the-moment flow — someone hands you a mystery item and you need a label for it right now. Printing from the product list is for batch work when you already know the SKUs. Both exist because both workflows are real.
Start printing
If you’re setting up a retail counter or fulfillment station that needs Shopify scan-barcode-variant-print in a single step, install Barcodeman from the Shopify App Store. Scan and Print is available out of the box, and the Free plan covers up to 100 labels a month for stores testing the workflow.
Before your first shift, run the variant barcode audit above so scanning lands on the right variant every time. For the wider POS context, see using Barcodeman with Shopify POS.