Skip to content

How to Print Barcode Labels

Products that arrive without a barcode need one printed. MultiPOS generates the code and lays it out for a label printer, and the whole job is getting the millimetres right.

Expect two attempts. Nobody gets label sizing right first time.

Take a ruler to the actual label stock, not the box it came in.

You want three numbers in millimetres: the label’s width, its height, and whether it comes on a continuous roll or as separate labels.

A common size is 28 by 89 millimetres, which is what MultiPOS ships as its default.

Those are the numbers the next step types in, so measure before you open the screen.

The Barcode Layout fields on the printer configuration tab

Go to DevDiggers Plugins → MultiPOS → Configuration → Printer.

The Barcode Paper section of the printer configuration tab

Field Default Enter
Page Width 28mm Your label’s width
Page Height 89mm Your label’s height, or 0 for a continuous roll
Page Margins 0mm Usually leave at zero

Page Height of 0 tells the printer the roll is continuous, so it cuts per label rather than per page. If your labels come out in one long strip when they should be separate, this is the field.

The Barcode Layout section with height, spacing and orientation fields

  • Generated Barcode Height defaults to 40mm. That is how tall the bars print, and it has to fit inside the label with room for the number underneath.
  • Unit Spacing Offset defaults to 50mm -3mm. It takes two values, vertical then horizontal, and the negative figure pulls labels together sideways so a two-across sheet does not drift apart.
  • Print Output Orientation is Vertical (Portrait) or Horizontal (Landscape).

The Print Output Orientation dropdown on the printer tab

Vertical suits a roll feeding label after label. Horizontal suits an A4 sheet of labels in a laser printer.

Click Save Changes.

Go to DevDiggers Plugins → MultiPOS → Assign Barcodes.

The Assign Barcodes screen with a barcode field and print controls per product

Find one product, enter a small quantity like 4 in the quantity field, and click Print.

The Print Label controls on a product row, with the quantity field and Print button

The browser print dialog opens. In it, check two things before you print:

  • Margins set to None. Browser margins fight the millimetre values you just entered.
  • Scale set to 100%. “Fit to page” silently resizes your barcode and it stops scanning.

Print onto plain paper first. Hold it against a real label and see where the edges land.

Compare and correct:

What you see Change
Bars run off the edge Reduce Generated Barcode Height or increase Page Width
Big gap between labels Reduce the first value in Unit Spacing Offset
Labels overlap sideways Make the second Unit Spacing Offset value less negative
The number under the bars is cut off Reduce Generated Barcode Height
Everything sits too high or too low Adjust Page Margins

Every one of those values lives on the same screen as step 2, so a correction is one edit and one Save Changes. Then reprint from the PRINT LABEL controls on Assign Barcodes.

The Print Label controls on the Assign Barcodes screen

Reprint on paper until it lines up, then print one real label and scan it.

A barcode that prints is not the same as a barcode that scans. Test it with the actual scanner before you print a thousand.

Once one label scans, work through the products that need labels. Enter the quantity you want per product and click Print.

Use the search box to find products rather than paging through the whole catalogue.

The product search box on the Assign Barcodes screen

Print the quantity you actually have in stock, not a round number. Spare labels for a product you have since reordered at a different price cause more trouble than they save.

Whatever is in that product’s barcode field. If the field is empty, the plugin generates one from the product ID or the SKU, depending on Barcode Synchronization under Configuration → General.

The Barcode Synchronization dropdown on the General tab