Fixing print problems

Almost every thermal-printing problem traces back to one of two things: a generic or AirPrint driver instead of the manufacturer’s, or a size mismatch between the app, the printer, and the loaded labels. Find your symptom below and jump to the fix.

It prints blank labels

A label feeds out but there’s nothing on it. In order of likelihood:

1. Wrong driver. A generic or AirPrint driver often misreads the label and ejects it blank. Install the manufacturer’s real driver for your exact model and select it in Settings. See Install the real driver. This is the fix in most cases.
2. Size mismatch. If BeamLabel is set to one size and the printer is loaded with another, the content can land off the label entirely. Match the app size, the OS paper size, and the physical labels — all three. See Matching the app to your media.
3. Darkness too low or wrong labels. Direct-thermal printing needs direct-thermal labels and enough heat. If the darkness is very low, or the labels aren’t thermal stock, the print is invisible. See Dial in darkness.
4. Needs calibration. If the printer has lost track of where each label starts and ends — most often right after a roll change — it can push out blanks while it hunts for the gap. Run your printer’s calibration and it re-learns the label edges. See Calibrate after a roll change.
5. Loaded upside down. Thermal labels only print on one side. If the roll is in backwards, every label comes out blank. Flip the roll.

It prints several labels per sale

One sale, but two to five labels come out — often blank ones. This is almost always a size mismatch, not a bug in the app: when the printer thinks the page is longer than the label loaded, it splits one slip across several labels.

1. Match the size everywhere. Set BeamLabel, your OS printer paper size, and the loaded labels to the same dimensions. A 4×6 slip sent to a printer set up for a smaller label is the classic cause of a multi-label fan-out. See Printers & setup.
2. Use the real driver. Generic and AirPrint drivers are the usual culprits behind extra labels because they guess the page geometry wrong. Install the manufacturer’s driver. See Install the real driver.
3. Calibrate the roll. If the printer can’t find the gap between labels, it may feed extras. Calibrate after any roll change. See Calibrate after a roll change.

If you recently switched label sizes in the app, double-check the printer is loaded with — and set to — that same size. Switching the app to 3×2 while 4×6 is still loaded will produce exactly this.

Labels are cut off, tiny, or sideways

The slip prints, but it’s clipped at an edge, shrunk into a corner, or rotated wrong.

1. Size mismatch, again. The content is being laid out for a different label than the one loaded. Align the app size, OS paper size, and physical labels. See Matching the app to your media.
2. Calibrate. After a roll change the print position can drift until the printer re-finds the label edges. See Calibrate after a roll change.
3. Check the driver’s scaling. Make sure the printer driver is set to print at 100% / actual size, not “fit to page” or “shrink to fit.”

Nothing prints at all

No label, no motion.

1. Is the right printer selected? Open Settings → Printer and confirm your thermal printer is chosen — not a PDF printer, a document printer, or a stale entry.
2. Is the printer online? Check that it’s powered on, connected, has labels loaded, and isn’t showing an error light. Print a test page from your OS printer settings to confirm the printer itself works.
3. Run a Test print in BeamLabel. It uses the exact same path as a live sale, so if the test works, live sales will too.
4. Reconnect over USB if you’re on wireless and the printer isn’t responding. See Prefer USB over wireless.

The print is too faint to read

Text comes out gray, patchy, or barely visible.

1. Turn up darkness. Most thermal printers have a darkness or density setting in their own software or driver — raise it until text is solid black. See Dial in darkness.
2. Check the labels. Faint prints often mean the label stock doesn’t match the printer, or the roll is old. Use fresh direct-thermal labels made for your printer.
3. Clean the print head per your printer’s manual if faintness is uneven or streaky.

A sale didn’t print

Every so often a sale doesn’t produce a label.

1. Payment failed. BeamLabel flags sales where the buyer’s payment didn’t go through, so an unpaid order doesn’t print and ship by mistake. Check the sale feed for the payment-failed flag — this is working as intended.
2. The connection dropped. If BeamLabel briefly lost its link to the show, it reconnects on its own, but a sale during the gap may need attention. Your end-of-show report always lists every sale, so nothing is truly lost — you can reprint from there.
3. Reprint from the list. Any sale in the live list or the end-of-show report can be reprinted individually.

The label-size dropdown looks wrong or shows one option

If the size dropdown is hard to read (for example, white-on-white in dark mode) or seems to show only one size, update to the latest version. This was fixed in version 1.0.12 — grab the current build from your account and reinstall. All eight sizes are always available; see Label sizes.

Still stuck?

If you’ve matched the size everywhere, installed the manufacturer’s driver, and calibrated, and it’s still misbehaving, we want to know. Email support@beamlabel.com with:

• Your printer’s exact make and model
• Which driver you’re using (manufacturer or generic/AirPrint)
• Your operating system (Mac or Windows)
• The label size loaded and the size set in the app
• What you’re seeing versus what you expected

With those five details we can almost always pinpoint it in one reply.