Image to ZPL Converter
Convert a logo or image into a ZPL ^GF graphic command. Resize, adjust contrast, dither and preview exactly what the printer receives.
Choose a file
PDF works too: each page becomes one label at its own size — a 4×6 page becomes a 4×6 label. If the label sits in a corner of a Letter or A4 page, tick "find and crop the 4×6 label". PDF to ZPL converter →
Settings
Thermal printers print 1-bit black and white. Dithering helps photos; plain logos are sharper with a threshold.
Choose a file — the result appears below.
Result
Printer preview
Graphic size:
Download the TSPL file (label.tspl) Binary file; send it straight to the printer (in BITMAP a 0 bit prints black).
ZPL output
How to convert a logo or image to ZPL
- Choose the image. Thermal printers print 1-bit black and white; colour is thresholded during conversion.
- Set width and height. Values are in printer DOTS, not screen pixels: on an 8 dpmm printer 203 dots ≈ 1 inch. The ceiling is 2000 dots on each side.
- Turn dithering on for photos; leave it off for flat logos and tune the threshold instead. Dithering fakes grey with dots and blurs sharp logo edges.
- Rotate, adjust contrast or threshold if needed; the preview shows the real 1-bit result the printer will produce.
- Press Convert and paste the resulting ^GF command into your label. Z64 compression shrinks the output noticeably — a long ^GF line slows the transfer to the printer.
When this is the right tool
When a label needs a company logo, a warning sign, a CE or recycling mark, or a signature image. Do NOT use it for barcodes: printing a barcode as an image makes it unreliable to scan — a barcode must be produced by the printer's own command (^BC, ^BQ) so module widths land exactly on the printer's dot grid.
Common problems
- The logo prints blurry or grey. — Dithering is on. Turn it off for flat-colour logos and tune the threshold; dithering is for photographs.
- The label prints very slowly. — ^GF data is large. Enable Z64 compression, avoid unnecessarily high resolution, and consider uploading a repeated logo into printer memory once (~DG) and recalling it.
- The image overflows the label. — Dots and pixels have been confused. Keep the width below the label's width in dots (8 dpmm × inches).
- My transparent PNG came out with a black background. — Transparency is treated as black. Flatten the image onto a white background and upload it again.
Save your labels to your account and print them with DirectPrint — free account. Create free account
Same engine, same result: REST API, command line, or an AI assistant over MCP. Anonymous calls work; an API key raises the quota.
curl -X POST "https://api.labelixa.com/v1/graphics" -F [email protected]claude mcp add --transport http labelixa https://api.labelixa.com/mcp # image_to_zpl