troubleshooting · printing-infrastructure
Printer Prints Blank Pages
Quick answer
Print a device self-test and an operating-system test page first. If those work, preview the exact artifact and isolate whether the failure is CSS visibility, wrong page size, unloaded assets, empty data, incompatible raw commands, or driver settings. On direct-thermal media, verify the heat-sensitive side faces the printhead.
Diagnose by path
HTML or PDF
- Inspect print preview for actual content.
- Check
@media print,display,visibility, color, and absolute positioning. - Wait for fonts and images before printing.
- Set the intended paper size and remove accidental blank-page breaks.
- Open the generated PDF independently.
Raw or thermal
- Print the printer’s built-in self-test.
- Confirm media orientation and correct media type.
- Verify the payload is non-empty and matches the printer language.
- Send a minimal initialization plus plain-text test using the correct encoding.
- Check image thresholds, width, row bytes, and buffer limits.
Avoid
Do not keep resubmitting a full job while diagnosis is uncertain. Use a clearly labeled one-line test and preserve the failing artifact or checksum.
Verify
Test text, image, and full layout separately on the target media. Confirm that the fix does not add trailing blank pages.
Related content
concept
ESC/POS Images
Learn how to convert logos and graphics into monochrome ESC/POS raster data, including sizing, thresholding, packing, chunking, and compatibility.
guide
How to Print HTML
Create a dedicated printable HTML document, apply paged-media CSS, wait for assets, and print it safely from JavaScript.
troubleshooting
Printer Prints Gibberish
Fix unreadable printer output caused by the wrong command language, raw-versus-driver mismatch, encoding, transport, or corrupted bytes.