Skip to main content
Print problems on event day are almost always one of four things: the loaded label stock doesn’t match the template size, the printer hasn’t been calibrated to the label gap, the darkness is set wrong for the media, or the print head is dirty. This page walks each one and the recipe to fix it without re-pairing the printer.
Before you start
  • Your printer is paired and the browser permission dialog accepted it. See Connect a printer.
  • A template is open in the editor. See Template editor.
  • Spare label rolls of the same stock, in case calibration burns through a few labels.

​
The label-size mismatch (most common)

Symptom: the print is shifted, lands on two labels, or leaves a large blank margin. The template’s Label size (in millimeters) doesn’t match the label loaded in the printer. Fix it in two steps:
1

Measure the loaded label

Take one label off the roll and measure it with a ruler in millimeters. Don’t trust the box. Labels sold as “4 × 2 in” can be 101.6 × 50.8 mm, 100 × 50 mm, or rounded variants.
2

Update the template Label size to match

In the editor’s left sidebar, pick the matching preset from the Label size dropdown, or type the measured millimeters into W (mm) and H (mm). The canvas resizes instantly. Click Print test again. The print should now land on a single label.
Full reference: Printer settings.

​
The auto-calibration recipe (gap sensing)

Symptom: the print is positioned correctly on the first label but slowly drifts down (or up) on every subsequent label. The printer can’t detect the gap between labels, so it advances by a fixed amount that gradually goes out of sync. Run the printer’s auto-calibration once at setup. The Zebra desktop printers in the Supported Zebra models list expose this through a button or menu:
1

Power off the printer

Switch the printer off at the power button.
2

Hold the FEED button and power on

Press and hold the FEED button (the one that advances a label) and turn the printer back on. Keep holding FEED.
3

Release after the flash sequence

The status light cycles through colors. Release FEED after one full red flash (the exact pattern varies by model, so check the printed quick-start card that came with the printer). The printer feeds a few labels, measures the gap, and stops.
4

Print a test

From the editor, click Print test. Prints should now land at the same vertical position on every label.
If your printer has a touchscreen (ZD420, ZD620), the same routine lives under Menu → Tools → Calibrate or similar. Consult the model’s quick-start sheet.

​
Blank prints (right size, no ink)

Symptom: the label feeds, the printer makes the right sound, but the label comes out blank. Two causes, listed in order of likelihood:
  • Direct-thermal label loaded upside-down. Direct-thermal labels only print on one side — the chemically treated side. Pull a label off, scratch the surface with a fingernail or coin: the side that darkens is the print side. If your loaded roll has the print side facing the wrong way, re-load with the right side facing the print head.
  • Wrong label type for the printer. Direct-thermal printers (Zebra ZD220, ZD230, etc.) cannot print on plain paper labels. If you loaded a non-thermal label roll, swap to direct-thermal stock.

​
Faint or smudged prints

Symptom: text and QR are readable but light, or QR codes fail to scan. The darkness is set too low for the media, or the print head needs cleaning.
  • Increase darkness on the printer. Use the Zebra Setup Utilities tool on the print-station laptop. Set darkness one or two steps higher, then re-test from the editor. Keep going until QR codes scan cleanly with a phone camera.
  • Clean the print head. Power off, open the printer, and wipe the print head with a 70% isopropyl alcohol pad in one long motion. Let it dry for 30 seconds before closing.

​
Labels peel off mid-print

Symptom: labels come out of the printer but won’t stick to the badge backing. This is a label-stock problem, not a printer or template problem. Cold venues (under 15 °C / 59 °F) reduce adhesive tack. Bring labels to room temperature for 30 minutes before the event starts. If the venue stays cold, switch to a higher-tack label adhesive. Your label supplier can recommend a cold-temperature stock.

​
The printer prints garbled characters

Symptom: random characters print instead of attendee names. The printer is in the wrong language mode. Zebra desktop printers can run in more than one command-set mode; Badge expects the default Zebra mode. Open Zebra Setup Utilities, connect to the printer, and set Programming Language to the Zebra default. Save and re-test from the editor.

​
The print station shows as DISCONNECTED while printing

Symptom: prints stop mid-event and the event header flips to DISCONNECTED. The browser tab closed, the laptop went to sleep, or the USB cable came loose. Reopen the template editor on the print-station laptop and re-pair the printer. See Connect a printer. The event returns to ACTIVE automatically once the connection is restored.