Published:
Paste code or load the sample — the result appears below, with the line and severity of each finding.
An area of the label that should be plain white comes out peppered with small dots. Nothing in the design is there — no text, no graphic, no colour. The cause is on one of two sides, and the fastest way to know which is to look at the file before touching the printer.
Open the ZPL in the ZPL preview. If the
dots appear in the rendered image, the printer is innocent: the file carries
them. The usual culprit is a bitmap (^GF) converted from a logo
or a scan whose background was not pure white — light grey, JPEG noise, a
paper texture. Conversion to one bit per pixel turns every grey into a
scatter of black dots, and the printer reproduces them faithfully. The fix is
in the source image: clean the background to white, or convert again with a
threshold that drops the light tones — the
image to ZPL converter lets you set that
threshold and see the result before it reaches the printer.
A clean render with dots on paper means the dots are added between the
file and the media. Three mechanisms cover almost all of it. Darkness
too high for the media: the heat meant for black elements bleeds
into neighbouring dots and direct-thermal paper starts to grey; lower the
darkness in steps (^MD in the format, or the printer's own
setting) until the white is white and the barcode still scans.
Contamination on the printhead: adhesive and dust from the
liner heat up under the elements and mark the paper; clean the head with the
manufacturer's recommended method and material, never with anything abrasive.
Worn or damaged elements: individual heater dots that stay
on or leak heat leave marks at the same horizontal positions on every label —
that is a printhead replacement, not a setting.
Print a few labels and compare. Dots at identical positions every time point to the head — dirt or wear; if cleaning removes them it was dirt. Dots scattered differently on every label, denser where the black elements are, point to darkness or media. Dots that appeared with a new media roll and nowhere else point to the media.
Cleaning a printhead does nothing for a noisy bitmap, and re-converting an image does nothing for a scorched background. One render decides which side you are on, and it costs no labels.
Washed-out, smudged or patchy thermal transfer print usually means ribbon type, label material and speed do not match. Zebra's own checks, in order.
Status requests take an age — or never come backA ~HS query that takes ages or never returns is rarely a slow printer: five printer states answer with silence, and a query behind an open connection waits.
How to Send ZPL Directly to a Network PrinterZebra network printers accept raw ZPL on TCP port 9100. How to send a file from Windows, macOS or Linux, from code, and what to check when nothing prints.
The printer answers ping, but port 9100 does notThe printer answers ping but nothing reaches port 9100: ICMP and the raw print service are different things. Four checks, in the order that isolates the cause.