Retest PC

Zebra Printer Test Page

Print a 4 x 6 or 2 x 1 inch test label on your Zebra, then print its configuration label and run a calibration from the buttons. Steps for ZD, GK and ZT models are below.

ZD, GK and ZT label printers4 x 6 and 2 x 1 inch labels
Label size
Test page
Download PDF5 KB

In the print window, pick your label printer and a 4 x 6 in label size, and set Margins to None.

Prints black on about 20% of the label. Thermal printers use no ink.

What your Zebra test label shows

Match the fault, then follow the fix

These are the faults this page shows most often. Match what you see on the receipt or label for the likely cause and the fix.

White lines down the print

Dirt or a dead dot on the print head leaves a white line along the paper. Clean the head. A line that stays means a worn head.

Faded or gray print

Darkness is set low, the paper is old or not thermal paper, or the head is dirty. Raise darkness in the driver and clean the head.

Thermal label printer test page

Labels skip or print over gaps

The printer has lost track of where each label starts. Run its label calibration and set the media type to labels with gaps.

Label print test page

Something else on the label? Every receipt and label fault with its fix is on the thermal printer test page.

This Zebra printer test page prints a full test label from your browser to a Zebra ZD, GK or ZT printer, sized for 4 x 6 inch shipping labels or 2 x 1 inch product labels. It checks the border on every edge, barcodes, a solid black bar for dead printhead dots, gray steps and small text. Zebra printers also print a configuration label from their own buttons and calibrate themselves to the labels you load, which fixes most skipping and misplaced printing. The button steps for each Zebra range are below.

How to print a Zebra printer test page on labels

  1. Load your labels and choose the matching size above the sheet: 4 × 6 in or 2 × 1 in.
  2. Press Print this page and choose the Zebra in the print window. Set the paper size to the same label size and the scale to 100% or Actual size, with no margins if the browser offers them.
  3. Check the label: the border should show on all four sides, the solid bar should have no white lines and every barcode should scan.
  4. For a printer without a driver on this computer, press Download PDF and print the file from a computer that has one.

The Zebra driver on Windows is called ZDesigner. Label size, darkness and speed set in the driver override what the browser sends, so set them there first.

The configuration label lists the printer's settings, such as darkness, print width and sensor type, and on network models a second report shows the IP address.

ZD410, ZD411, ZD420, ZD421, ZD620 and ZD621

These Link-OS desktop printers share the same FEED, PAUSE and CANCEL buttons, and Zebra's guides give the same steps for them.

  • Printer on: make sure labels are loaded and the cover is closed, then press FEED and CANCEL together for two seconds. The Printer Configuration and Network Configuration reports print, and the printer returns to ready.
  • Printer off: hold CANCEL while you turn the power on, and keep holding until the Status light is the only one lit.

GK420d and GK420t

The GK series has a single FEED button and a status light. Load labels and close the top cover, then turn the printer on.

  1. If the light blinks green, the printer is paused. Press FEED once to make it ready.
  2. Press FEED two or three times so the printer can measure the labels you loaded.
  3. When the light is solid green, hold FEED until the light flashes once, then let go. The configuration label prints.

Holding FEED for more flashes starts other modes: two flashes runs a media calibration, five adjusts the print width, six adjusts the darkness and seven runs a manual calibration. Four flashes resets the printer to factory defaults, so count carefully and let go at the right flash.

ZT411 and other ZT industrial models

The ZT411 has a color touch display. Touch Menu, then System, Settings and Print: System Settings for the printer configuration label. The network label is Print: Network Info in the network settings menu. The buttons work too: hold CANCEL while the printer powers up, or press FEED and CANCEL together for two seconds when it is ready, and both labels print. Zebra's ZT411 user guide covers the PAUSE self-test and the other diagnostics in its Diagnostics and Troubleshooting chapter.

Calibrate the labels

Calibration teaches the printer where each label starts and ends. Run it after changing to a new label size or type, and whenever labels skip, print over the gap or stop halfway.

  • ZD models: with labels loaded and the printer ready, press PAUSE and CANCEL together for two seconds. The printer feeds and measures several labels, then returns to ready. Zebra calls this SmartCal.
  • GK420d: hold FEED until the status light flashes twice. It feeds one to four labels while it measures them.
  • ZT411: touch Menu, then Print, Sensors and Manual Calibration, or hold PAUSE, FEED and CANCEL together for two seconds. The ZT411 can also calibrate by itself at power up or when you close the printhead, depending on its Power Up Action and Head Close Action settings.
  • Pre-printed labels, printing on the liner, or when the automatic calibration fails: use the manual calibration, seven flashes on the GK420d, or the manual media calibration in your ZD model's guide.

In Windows, open the printer's properties and click Print Test Page on the General tab. If it prints, Windows reaches the printer through the ZDesigner driver. In Zebra Setup Utilities, select the printer and click Open Printer Tools, where you can send the configuration label from the computer. On a network printer you can also send a plain text file containing the three characters ~WC, the Zebra command that prints the configuration label.

On a Mac, Zebra printers print through CUPS. Open Print Center, select the Zebra and choose Printer, then Print Test Page, which shows whether macOS can reach it.

What the Zebra test label should show

Part of the label Good result Fault and likely cause
Border All four edges show Missing on one side: wrong label size in the driver
Solid black bar Even black, no white lines Thin white lines along the label: dirt or dead dots on the printhead
Barcodes and QR code Scan first time Will not scan: darkness too high or too low, or speed too fast
Gray steps 25 to 100% Four different shades All very light: darkness too low or old labels
Text 6 to 10 pt Sharp and readable Fuzzy: darkness too high

Use the barcode scanner test to check the codes with your own scanner or phone camera.

White lines and faint print

A white line that runs along the label in the same place every time is a printhead fault. Clean the printhead first: Zebra's guides use a Zebra cleaning pen, or a lint free swab moistened with isopropanol, wiped along the dark strip of the printhead with the printer off. Let it dry before printing. If the line stays after cleaning, that part of the printhead is worn and the printhead needs replacing.

Faint print across the whole label usually means the darkness is set too low, the labels are old or stored in heat, or, on a thermal transfer model, the ribbon and labels do not suit each other. Raise the darkness a step at a time in the driver and print the label again.

Blank labels

Direct thermal printers, such as the ZD421d, need heat sensitive labels. Scratch a label with a fingernail: if it leaves a dark mark, it is a direct thermal label. Thermal transfer printers, such as the ZD421t, need a ribbon, and a ribbon loaded with the ink side away from the label prints nothing. For more causes, see printer printing blank pages.

The configuration label prints but nothing else does

If the configuration label prints from the buttons, the Zebra works and the problem is between the computer and the printer. Check that the label size and media type in the ZDesigner driver match the labels, clear the print queue and restart the Print Spooler, and make sure the port matches the connection, USB or the IP address on the network configuration report. The full checklist is in why is my printer not printing.

What this test page cannot check

The browser sends the label like any document, so it cannot change the printer's darkness, run a calibration or read its sensors. Use the buttons, the ZDesigner driver or Zebra Setup Utilities for those. Receipt printers use rolls rather than labels: the receipt printer test page has 58 mm and 80 mm versions, and the general thermal label printer test page covers other label printer brands.

Zebra test page questions

How do I print a configuration label on a Zebra ZD421?

With labels loaded and the printer on and ready, press FEED and CANCEL together for two seconds. The printer prints its Printer Configuration and Network Configuration reports, then returns to ready. Zebra gives the same combination for the ZD410, ZD411, ZD420, ZD620 and ZD621.

How do I print a test page on a Zebra GK420d?

Load labels, close the cover and turn the printer on. When the status light is solid green, hold FEED until the light flashes once, then let go. A configuration label prints.

How do I calibrate a Zebra label printer?

On ZD models, press PAUSE and CANCEL together for two seconds. The printer feeds a few labels while it measures them. On a GK420d, hold FEED until the status light flashes twice. On a ZT411, touch Menu, then Print, Sensors and Manual Calibration, or hold PAUSE, FEED and CANCEL together for two seconds.

Why does my Zebra print blank labels?

Direct thermal printers need heat sensitive labels, which darken when you scratch them with a fingernail. Thermal transfer printers need a ribbon loaded the right way round. If the labels are right, turn up the darkness and clean the printhead.

What is the Zebra Browser Print test page?

Zebra Browser Print is Zebra's helper app that lets websites send labels straight to a Zebra printer. If a website cannot print, first print the configuration label to prove the printer works, then check that Browser Print is running and can see the printer.

Why does my Zebra skip labels or print across the gaps?

The printer has lost track of where each label starts, usually after you change the label size. Run a calibration, and make sure the media type in the driver matches the labels: labels with gaps, black marks or continuous.