Skip to content
Gookit Help

Pick your store platform

Choose your store platform and install BarcodeMan. Plans, pricing and trial eligibility vary by platform. Confirm the available plans in the app and the final charge on the approval or checkout screen.

Keep your list in Google Sheets instead? BarcodeMan for Google Sheets

Articles

WooCommerce SKUs and barcodes

How BarcodeMan reads WooCommerce product and variation data, what a barcode element can encode, how the SKU generator previews before writing, and why a barcode prints blank.

Verified
On this page

BarcodeMan reads your WooCommerce catalog each time you print, so a label shows the product data at that moment. It writes back only one thing, SKUs, and only after you confirm a preview. This article covers which fields reach the label, what a barcode element can encode, how variations get their own SKUs, and what to check when a barcode prints blank.

What BarcodeMan reads from WooCommerce

For product labels, each simple product and each variation becomes one row in your print list with its own data:

On the labelComes from WooCommerce
Product nameThe product’s name
DescriptionThe short description, or the full description if the short one is empty
PriceThe product’s or variation’s current price. A variation with no price of its own prints blank; it does not borrow the parent’s price.
Compare-at priceThe regular price, shown only while the item is on sale with a sale price
SKUThe variation’s SKU; for a simple product, the product SKU
BarcodeThe product’s or variation’s GTIN, UPC, EAN, or ISBN field (see below)
WeightThe variation’s weight, or the parent’s if the variation has none, with your store’s weight unit
Variation optionsThe variation’s attribute values, such as Size: Large
StockThe stock quantity
Product image and variation imageThe product’s first image; the variation’s own image when it has one
Product and variation IDsWooCommerce’s numeric IDs
Product URL (QR codes)The product’s permalink

Updated prices and names appear the next time you print. The label designer and the print list show your store’s current values; BarcodeMan keeps a copy of the label design, not of your catalog.

Vendor is not available on WooCommerce. A text element that was bound to Vendor in an older template shows that option as unavailable until you pick another field.

What a barcode element can encode

Select a barcode element in the label designer and open Link to. On WooCommerce the choices are:

  • BARCODE: the value in WooCommerce’s GTIN, UPC, EAN, or ISBN field for that product or variation.
  • SKU: the SKU field.
  • Custom barcode: a value you type. Every label prints the same value.
  • PRODUCT_ID: WooCommerce’s numeric product ID.
  • VARIANT_ID: the variation’s numeric ID. For a simple product this is the product’s own ID.

QR code elements offer BARCODE, SKU, a custom value, the online store product URL, PRODUCT_ID, and VARIANT_ID.

WooCommerce’s barcode field

WooCommerce had no barcode field for most of its history. Merchants put barcodes in the SKU field or in a plugin’s custom field. WooCommerce 9.2 added a GTIN, UPC, EAN, or ISBN field in the product’s inventory settings, and variations have their own copy of it.

BarcodeMan reads that field as BARCODE, keeping leading zeros. It is read-only: BarcodeMan never writes to it, and the SKU workspace has no Generate barcodes action on WooCommerce. If your store runs an older WooCommerce, or the field is empty, BARCODE is blank and the barcode area prints empty.

BarcodeMan does not read barcodes from custom fields or third-party plugin fields. If your barcodes live somewhere else, you have three options: copy them into WooCommerce’s GTIN field, copy them into the SKU field and bind the element to SKU, or encode PRODUCT_ID or VARIANT_ID when any unique number will do.

Choosing a format

The barcode element’s Barcode Type list shows CODE128 (Most Used), EAN13, UPCA, UPCE, CODE39, ISBN, EAN8, and GS1-128. The format must accept the value you bind to it:

  • EAN-13, EAN-8, UPC-A, UPC-E, and ISBN need digits only, at the right length, with a valid check digit when you supply one. Use them for real retail codes stored in the GTIN field.
  • GS1-128 needs GS1 application identifier data.
  • CODE128 accepts letters, digits, and common symbols at any length. Use it for SKUs, product IDs, and variation IDs.

If you are unsure, pick CODE128. See Barcode format guide for each format’s rules.

Each variation has its own SKU

In WooCommerce a variable product has a parent SKU, and each variation can have a SKU of its own. The two behave differently on labels and in the SKU workspace:

  • On the label, a variation with its own SKU prints it. A variation without one prints the parent product’s SKU, which is how WooCommerce itself reports it. If several variations share a parent SKU, their SKU barcodes are identical.
  • In the SKU workspace, a variation without its own SKU counts as missing one, even when it inherits the parent SKU. This uses the variation’s stored value, which the plugin exposes from version 1.2.1. On an older plugin the generator could not handle such variations correctly; ask a site administrator to update it from the Plugins page.

Give each variation its own SKU if you need sizes and colours to scan as different items. Variations in the print list keep their own quantities, so each one gets its own labels.

Generate SKUs with a preview

The SKU workspace fills in missing SKUs and fixes duplicates. It never changes anything until you confirm.

  1. In the BarcodeMan workspace, open SKUs in the sidebar, or use Fix SKUs on the home page when it reports variants missing SKUs. You land in Generate or fix SKUs. There is no separate barcode generator on WooCommerce.
  2. Switch between Missing SKU, Duplicated, and All variants. Search and filters work as in the product browser, and each variation is its own row showing product, variant, SKU, barcode, stock, and the issue.
  3. Select the rows to fix and choose Generate. You can adjust the pattern in Customize pattern.
  4. Review the preview. It shows the exact SKU proposed for every selected variant, and you can edit a proposed value before confirming. A preview covers up to 300 selected variants at a time.
  5. Confirm with the Update button. Only then does BarcodeMan write to WooCommerce. Each row shows Updated, or stays listed with its reason if WooCommerce rejected it, for example because the SKU is already in use. Use Retry failed for rejected rows and Done when you are finished.

When the preview includes replacements for duplicated SKUs, the scope note says those selected SKUs will be replaced. Otherwise only missing SKUs are filled; existing ones stay as they are. Duplicate checks against your store run when you confirm, and a conflicting row is rejected rather than silently given a different value.

Generated SKUs are internal identifiers, not retail GTINs. If a retailer or marketplace needs a GTIN, use the one assigned to the product and put it in WooCommerce’s GTIN field. For the pattern options, see SKU and barcode generator; the Shopify-specific Assign dialog and Barcode field in that article do not apply to WooCommerce.

Scan and print matches SKUs

Scan and print builds a print list from a scanner. The scanned value must match a SKU exactly: BarcodeMan does not search names or the GTIN field, and it does not pick the first search result when there is no exact match or several matches. If you want to restock by scanning your own labels, print barcodes from SKU. A label that encodes PRODUCT_ID, VARIANT_ID, or the GTIN field will not be found this way.

Fix a blank barcode

A blank barcode area has one of two causes. Check them in this order.

The linked value is empty. Select the element and read its Link to source, then check that exact field on the affected variation:

  • SKU blank: neither the variation nor its parent has a SKU. Use Generate or fix SKUs, or enter one in WooCommerce.
  • BARCODE blank: the GTIN, UPC, EAN, or ISBN field is empty on that variation, or your WooCommerce version does not have the field. Fill it in WooCommerce, or switch the element to SKU.
  • Custom barcode blank: type a value in the element’s Value field.

The format rejects the value. An EAN-13 element with a SKU like TS-BLK-L prints nothing, because EAN-13 accepts digits only. Switch to CODE128, or bind a value that fits the format. A 13-digit value is not automatically a valid EAN-13 either; its check digit must be correct.

Labels use the values stored in WooCommerce at the time you print. After you save a new SKU or GTIN in WooCommerce, preview or print again to see it on the label.

For the generic version of these checks, see Barcode not showing on label. If the barcode prints but a scanner cannot read it, see Printed barcode won’t scan.

Questions about this article? Email our team.

Send feedback