Nine out of ten label printer faults are one of four things: the media setting does not match the stock, the printer has not been calibrated since the stock changed, the print density is wrong for the material, or the label file is not the size the printer thinks it is. This guide starts with the two-minute check that separates a printer fault from a software fault, then works through twelve symptoms in the order you will meet them.
If the software will not install at all
This is the one fault that happens before printing and is not a printer problem. The installer depends on two Microsoft runtimes that are not present on every Windows machine, and when either is missing the installation fails or the software opens to a blank window.
WebView2 Runtime. The editor uses the Edge WebView2 runtime to render. Download it from Microsoft's WebView2 page — the "Evergreen Bootloader" link at the bottom of that page — and install it before retrying the label software.
.NET Framework 4.8. Available from Microsoft's .NET Framework download page. Windows 10 and 11 usually ship with it and Windows 7 frequently does not, which is why installs on older machines fail more often.
Install both, then run the label software's installer again. Neither download is large, and both are official Microsoft packages — there is no need to look for a third-party fix.
Before you change anything: the two-minute check
Print the printer's own test page before touching any setting in the label software. This is the single most useful diagnostic step, because it splits every problem into two halves.
If the test page prints correctly — clean, correctly aligned on the label, correct darkness — then the printer, the media and the driver are fine, and the fault is in the label file or the software settings. Stop looking at hardware.
If the test page is blank, misaligned or faint, the fault is below the software: media settings, calibration, density, or the printhead. No amount of redrawing the label will fix it.
Most printer drivers expose the test page from the printer properties dialog — the same dialog you reach when you open the printer's settings rather than the document's. Printing a test page from there uses the driver's own data, which is exactly what makes it a clean test.
The four settings behind most failures
These four live in the printer driver, not in the label design. They are also the four that get changed by accident and never changed back.
1. Media type: gap, black mark or continuous
Thermal label stock comes in three forms, and the printer needs to be told which one it has. Gap labels have a translucent gap between each label, which the sensor detects. Black mark stock carries a printed registration mark on the backing paper. Continuous stock has no gaps or marks at all and relies on the software to define the length.
A printer expecting gaps but loaded with black-mark stock will either feed continuously or print one label across two. The stock type is usually printed on the box or the inner core label — check it before selecting a media type at random.
2. Calibration and label length
After loading new stock, the printer needs to learn where the gaps are. Most thermal printers do this with a feed or calibration button sequence, or through the driver's calibration command. A printer that has not been calibrated on the current stock will place the print a few millimetres high or low on every label, consistently — which is the signature of a calibration problem rather than a design problem.
Consistent offset in one direction, on every label, is calibration. Offset that grows as the run progresses is a label length setting that is slightly wrong: a 0.5 mm error per label becomes 25 mm over fifty labels, and by the end of the roll the print is on the gap.
3. Print density (darkness)
Density is how much energy the printhead applies. Too low and the barcode is grey and will not scan; too high and the edges of bars bleed into the spaces, which produces a barcode that looks black and bold and still will not scan. Both failures look like printing problems and both are fixed by one setting.
A colour or material change on the same printer invalidates the density setting that worked before. Set density by printing a barcode and scanning it with the scanner you will actually use, not by judging it by eye.
4. Orientation and rotation
Label printers feed on one axis. A landscape design sent to a printer configured for portrait comes out rotated 90 degrees, and the usual reaction — rotating the design 90 degrees in the software — fixes that job and breaks the next one. Set the orientation in the printer settings and leave the design alone.
Twelve symptoms and what each one means
| Symptom | Most likely cause | First thing to try |
|---|---|---|
| Labels print blank | Media type wrong, or thermal side facing the wrong way | Check the stock is loaded with the coated side toward the printhead, then print the driver test page |
| Nothing prints at all | Wrong printer selected, or a job stuck in the queue | Check the queue for a paused or error-state job before anything else |
| Printer light flashing, no movement | Out of media, cover open, or a sensor error | Open and close the cover, check the roll, then power-cycle |
| Print sits too high or too low | Calibration, or wrong label length in the driver | Re-calibrate on the current stock |
| Print sits too far left or right | Page width in the driver does not match the stock width | Correct the label width in the printer settings, not the design |
| Print comes out rotated | Orientation mismatch between design and driver | Set orientation in the printer settings |
| A blank label between every print | Media type set to continuous, or label length set double | Set the media type to gap, then recalibrate |
| Print is too faint | Density too low, or a worn ribbon, or the wrong paper side | Raise density one step and re-test |
| Print is too dark, bars bleed | Density too high | Lower density one step and scan-test the barcode |
| Stops halfway through a run | Spooler limit, USB dropout, or the printer buffer filling | Split the job into blocks of a few hundred |
| Job will not cancel | The job is stuck in the spooler, not on the printer | Clear the queue, then power-cycle the printer |
| Barcode prints cleanly but will not scan | Density or bar-width setting — not the data | Check the human-readable line, then the barcode size |
When the problem is the file, not the printer
If the driver test page is perfect and the label is still wrong, the fault is in one of three places.
The canvas size does not match the stock. A design created at 100 × 150 mm printed onto 100 × 100 mm stock will clip or scale. This is the most common cause of "the bottom half is missing" and the fix is to set the canvas size from the physical stock before designing anything.
Multi-column layout on a single-label printer. A design set up as a multi-column A4 sheet sent to a roll printer will produce one column and discard the rest. Multi-column layouts belong to sheet printing; roll printing uses one label per page.
The rotation was applied to the design rather than the print. Once a design has been rotated to compensate for a printer setting, every subsequent change of printer reintroduces the problem. Keep the design in its natural orientation and fix rotation at print time.
When the fault is not fixable in software
Two hardware symptoms justify stopping the software work.
A consistent white stripe through every label. That is a damaged printhead element or a crease in the ribbon. Clean the printhead with isopropyl alcohol and a lint-free swab; if the stripe survives cleaning and moves with the ribbon rather than the head, it is the ribbon. If it stays in exactly the same position on every label, it is the head, and printheads are a consumable with a finite life.
Barcodes that scan on one side of the label and not the other. Uneven density across the width usually means the printhead is worn on one side, or the media is not sitting flat against it. Check the media guides first — a roll that is not seated squarely produces exactly this symptom.
Frequently asked questions
Why is my label printer printing blank labels?
The three usual causes are stock loaded with the thermal layer facing away from the printhead, a media type setting that does not match the stock, and a printhead that needs cleaning. Print the driver's own test page first: if that is also blank, the fault is hardware or media, not the label file.
Why are my labels printing a few millimetres off?
Consistent offset on every label is a calibration problem — the printer has not learned where the gaps are on this stock. Offset that increases down the roll means the label length in the driver is slightly wrong. Recalibrate first, then measure the actual label pitch and correct the length setting.
Why does my printer skip a label between prints?
Almost always a media type set to continuous when the stock has gaps, or a label length configured at roughly double the real pitch. Set the media type to gap and recalibrate. If it persists, the gap sensor is dirty.
How do I clear a print job that will not cancel?
Cancel it from the print queue, wait for the spooler to release it, and if it stays, restart the print spooler service. Power-cycling the printer does not clear a job held in the Windows queue — the queue has to be cleared first, or the job returns as soon as the printer comes back.
Why is my print too light to scan?
Density too low, ribbon worn, or the wrong side of the media facing the head. Raise density one step, reprint, and test with the scanner you actually use rather than reading it by eye — a barcode that looks acceptable to a person can be well below a scanner's threshold.
Why is my label printing sideways?
Orientation mismatch between the design and the printer configuration. Fix it in the printer settings. Rotating the design in the software appears to work but breaks the next job, and leaves the file permanently in the wrong orientation.
Do I have to recalibrate when I change label stock?
Yes, whenever the pitch or the material changes. The printer has to relearn where the gaps are. Skipping this step is the single most common reason a new roll prints offset from the first label.
A label printer that is printing badly is almost never broken. It is being told something about the stock that is not true — the wrong media type, the wrong length, the wrong density. The test page tells you which side of that conversation the problem is on, and the answer is usually a setting you changed once and forgot.
barcode and QR code labels · MasoLabel review · print labels from PDF
Need a hand with your own setup? Email labelprintingforalways@gmail.com or message us on WeChat at 18701979438. Questions about the free version are welcome too.