LabelCross PrintDocumentation
Help center← Site
Documentation  ›  Support  ›  Troubleshooting

Troubleshooting

The operator station shows no printers

A printer appears only if it is enabled, attached to exactly one started flow with a single Label printing step, and your profile has access to its group.

Printing fails or “timeout”

Check the printer IP:port and network reachability (ping, port 9100, firewall), increase the print timeout, and read the exact message in Production › Print history.

“Connection refused” to a TCP/IP printer

The printer isn’t listening on the port (often 9100), another app holds the connection, or a firewall/VLAN blocks it.

“Invalid barcode data” / print refused

The strict pre-print check refuses an invalid value (wrong check digit, length or characters), or an object that overflows the label. Fix the source data or the layout.

Prints come out blank or with missing variables

A variable missing from the data prints blank. Check the mapping, and enable Reject empty variables to block printing instead of printing blank.

“Service stopped: no active license”

Activate or re-activate the license, or start a demo. Causes: expired/revoked license, clock moved backwards, or the installation copied to another machine.

The printed label differs from the preview (Fingerprint/DPL)

Run Image method diagnostic on the printer and select the method that matches the preview.