In this guide, we'll list some common issues with printing and using DirectPrint, as well as how to fix them.
Printers Not Showing
If your printers aren't showing up in Veeqo, you can try to resolve this with the below steps:
For Mac Users
For Mac Users
Due to a bug with Java, printer listings may fail on Mac.
The current fix is to:
Open your Mac's System Preferences.
Go to Printers and Scanners.
Right Click > Reset Printing System.
Re-add all printers.
For Windows Users
For Windows Users
Sometimes, users report being able to list just one printer, or listing printers takes several minutes to complete. This is likely caused by a driver conflict with another printer or printer driver. To fix this, you will need to remove your printers and establish which one is causing the conflict. Most printers have online guides for troubleshooting this as steps can differ based on the printer brand.
IMPORTANT: DirectPrint is not supported on Chromebook/AndroidOS at this time. You will not be able to configure your printers for use with Direct Print on these devices
Common Shipping Label Problems
Common issues with shipping labels include:
Labels too small or big
Wrong orientation
Blurry barcodes
Printing multiple copies
Most of the time, these issues can be resolved using the following steps depending on your device:
NOTE: These steps will feed some blank labels through your printer while it recalibrates.
For Mac Users
For Mac Users
f you use a MacOS device:
To set up a custom paper size 4in x 6in it is easiest to use Word. You can also use Adobe Reader, Preview, or other document viewing applications to help setup a custom paper size.
Open Word and then select File and Page Setup.
Select the drop down next to "Format For: and choose the printer you are using for labels.
Select the drop down next to "Paper Size" and either choose a pre-saved format or create a custom one. If you are creating a custom one:
Click the "+" icon and name your template.
Set the Width to 4 inches (101.6mm) and the height to 6 inches (152.4mm).
Set all of the margins to 0.
Click OK to save.
Check that the correct orientation is selected.
Click OK to save.
Word will show you the paper size you created. Write TEST on the page and print.
If the test printed successfully, go to System Preferences on your device.
Choose Printers and Scanners.
Select your label printer from the list.
Change the default paper size to the template you just created.
Save this change to the printer. Now, your labels printed through Veeqo should be correct.
For Windows Users
For Windows Users
If you use a Windows device:
Select the 'Devices and Printers' option within the 'Control Panel' of the computer. Right click on the label printer (Zebra in our example) and select 'Printer Properties' (Printer names may vary).
In the following pop-up window go to the 'Advanced' tab then select 'Printing defaults'.
In Printing defaults set Paper Format to 'inch', Size Width to '4.00' and Size Height to '6.00'.
You will now need to calibrate your printer. To do this click on the 'Tools' tab. Then click 'Action' and 'Calibrate media' then click 'Send' at the bottom of the page.
Next click on the Dithering tab and select none.
Then click 'Apply' and 'OK' and you will be returned to the 'Advanced' screen where you originally selected 'Printing Defaults'.
Any other setting here reduces the accuracy of the 2D barcode to the point where the labels you produce may not scan through your shipping carriers network.
NOTE: Setting Dithering to None ensures that the newer 2D barcode is printed properly and will scan through the network.
Other Troubleshooting Steps
Conflicting Applications
Conflicting Applications
The following applications may cause issues with installation:
Old Java versions: DirectPrint only works with Java 11 or higher. Older versions may conflict with DirectPrint and cause it to fail to start.
Antivirus Software: Some antivirus applications may prevent DirectPrint from installing or running.
Comodo Antivirus will force application containment on the DirectPrint installer and prevent it from being installed, uninstalled and prevent it from running. Moreover, disabling Comodo will have very little effect because it will re-enable itself without warning. DirectPrint is not supported with Comodo Antivirus.
Other Antivirus:
Application containment: If the antivirus forces application containment, please disable this application containment for DirectPrint and the Java Runtime which it uses. Use your antivirus online guides to find out how to do this.
Web Filtering: If the antivirus blocks access to local ports or localhost certificates, please disable or allowlist
https://localhost:8181,http://localhost:8182.Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or allowlist the DirectPrint installer.
General Errors with DirectPrint
General Errors with DirectPrint
Some errors include:
Connection Failures: DirectPrint fails to establish a connection with Veeqo, preventing label printing
Application Crashes: DirectPrint may crash or become unresponsive when attempting to connect
No Response: Clicking the DirectPrint button produces no action or error message
Intermittent Connectivity: Connection works sporadically but fails unpredictably
This may be caused by Chrome updating to version 147+, as the new Local Network Access security feature blocks the connection between Veeqo and DirectPrint by default. The connection requires explicit user permission to function properly. To resolve this:
Open Chrome and navigate to Settings > About.
Check if the Chrome version is 147 or higher.
If no, contact support. If yes, proceed with the following steps:
Navigate to Chrome's Site Settings.
Check if the Veeqo certificate has expired.
If expired, remove the certificate:
Click on the certificate entry.
Select the option to remove/delete it.
Refresh the Veeqo page.
A prompt should appear asking you to grant access.
Accept the prompt to add the new certificate.
Go to chrome://settings/content/siteDetails?site=https://app.veeqo.com
Alternative method: On your Veeqo page, click the site settings icon in the address bar
Locate and review the following permissions:
Local Network Access: Should be set to "Ask" or "Allow".
Apps on Device : Should be set to "Ask" or "Allow".
Check your DirectPrint logs (steps below). You should see connection messages appearing, this means the issue is resolved. If the issue persists and no connection messages appear, continue to step 12.
While in Veeqo, right-click anywhere on the page.
Select Inspect from the context menu.
Navigate to the Console tab.
Look for any error messages related to QZTray.
Contact the support team and share the errors for troubleshooting.
Accessing Your DirectPrint Logs
Accessing Your DirectPrint Logs
Sometimes you may want to see your logs for DirectPrint, often if our support team asks for them, to get to your logs follow these steps:
Open the DirectPrint application.
Once DirectPrint has loaded, you will see the Veeqo logo appear at the top of the screen.
Click on the Veeqo logo and choose “Advanced”.
Click “Diagnostic”.
Click “View Logs.” This will show you a live feed of your printing logs.
Go back to Veeqo and refresh the page with the logs still open. Text should appear in the log window and will show any errors with the connection.