Skip to main content

Set up barcode label printing for Inventory Items

This guide explains how to set up barcode label printing in ProcureDesk using a Zebra-compatible label printer and QZ Tray. ProcureDesk uses QZ Tray to send barcode labels from your browser to a label printer installed on your computer.

Before you begin

To print barcode labels from ProcureDesk, make sure you have:

Requirement

What you need

Label printer

A Zebra-compatible label printer

Printer driver

Installed on your computer

QZ Tray

Installed and running on your computer

Printer name

The printer name must include Zebra

Browser access

Allow QZ Tray prompts if shown

Important: QZ Tray must be installed and running on the same computer where you use ProcureDesk.

Supported printer type

ProcureDesk currently prints barcode labels using ZPL format.

Please use a printer that supports Zebra/ZPL label printing.

Examples include:

  • Zebra ZD421

  • Zebra GK420d

  • Zebra ZT Series

  • Other Zebra-compatible ZPL printers

Step 1: Install your label printer

Connect the printer

Connect the label printer to your computer using one of the supported connection methods:

  • USB

  • Network

  • Bluetooth, if supported by your printer and driver

Install the printer driver

Install the printer driver provided by your printer manufacturer.

For Zebra printers, this is commonly the Zebra ZDesigner driver.

Confirm the printer is installed

After installation, confirm that the printer appears in your computer’s printer list.

Windows

  1. Open Settings.

  2. Go to Bluetooth & devices.

  3. Click Printers & scanners.

  4. Confirm that the Zebra printer is listed.

macOS

  1. Open System Settings.

  2. Go to Printers & Scanners.

  3. Confirm that the Zebra printer is listed.

Step 2: Confirm the printer name

ProcureDesk looks for a printer name that contains:

Zebra

Make sure your printer name includes the word Zebra.

Valid printer name examples:

Zebra ZD421
Zebra GK420d
Zebra Label Printer

A printer name like this may not work:

Warehouse Label Printer

If your printer name does not include Zebra, rename the printer in your computer’s printer settings.

Important: If the printer name does not include Zebra, ProcureDesk may not be able to find the printer.

Step 3: Install QZ Tray

Download QZ Tray

Download QZ Tray from the official website:

https://qz.io/download/

Install QZ Tray

Run the installer and complete the installation using the default options.

Start QZ Tray

After installation, start QZ Tray.

You should see the QZ Tray icon in your system tray or menu bar.

Windows

Look for the QZ Tray icon near the clock in the system tray.

macOS

Look for the QZ Tray icon in the menu bar.

Important: QZ Tray must remain running while printing barcode labels from ProcureDesk.

Step 4: Test QZ Tray

Before printing from ProcureDesk, confirm that QZ Tray can detect your printer.

  1. Open the QZ Tray demo page in your browser:
    ​ https://demo.qz.io

  2. Confirm that your browser can connect to QZ Tray.

  3. List the available printers.

  4. Confirm that your Zebra printer appears in the printer list.

If the Zebra printer does not appear, check that:

  • QZ Tray is running.

  • The printer is installed on your computer.

  • The printer is powered on.

  • The printer is online.

  • The printer name includes Zebra.

  • The correct printer driver is installed.

Step 5: Print a barcode label from ProcureDesk

After the printer and QZ Tray are installed:

  1. Log in to ProcureDesk.

  2. Go to Inventory.

  3. Find the inventory item.

  4. Click the printer icon.

  5. Review the barcode preview.

  6. Click Proceed To Print.

  7. If QZ Tray shows a browser or security prompt, approve it.

  8. The barcode label should print.

What to expect

When setup is complete:

  1. You click the printer icon in ProcureDesk.

  2. A barcode preview opens.

  3. You click Proceed To Print.

  4. QZ Tray sends the label to your Zebra printer.

  5. The barcode label prints.

Troubleshooting

QZ Tray is not connected

This may happen if:

  • QZ Tray is not installed.

  • QZ Tray is installed but not running.

  • Your browser cannot connect to QZ Tray.

  • QZ Tray was closed after installation.

To resolve this:

  1. Start QZ Tray.

  2. Confirm the QZ Tray icon is visible.

  3. Refresh the ProcureDesk page.

  4. Try printing again.

  5. If the issue continues, restart QZ Tray and your browser.

No Zebra printer found

This may happen if:

  • The printer is not installed.

  • The printer is offline.

  • The printer name does not include Zebra.

  • QZ Tray cannot detect the printer.

To resolve this:

  1. Confirm the printer is installed on your computer.

  2. Confirm the printer is powered on.

  3. Confirm the printer is online.

  4. Rename the printer so the name includes Zebra.

  5. Test printer visibility at:
    ​ https://demo.qz.io

Label does not print

This may happen if:

  • The printer is offline.

  • Labels are not loaded correctly.

  • The printer is paused.

  • QZ Tray is not running.

  • The wrong printer is selected by the operating system.

  • There is a printer driver issue.

To resolve this:

  1. Confirm the printer is powered on.

  2. Confirm labels are loaded correctly.

  3. Confirm the printer is not paused.

  4. Confirm QZ Tray is running.

  5. Print a test label from the printer driver.

  6. Try printing again from ProcureDesk.

Printer prints code or text instead of a barcode

This may happen if the printer is not configured for Zebra/ZPL raw label printing.

To resolve this:

  1. Confirm the printer supports ZPL.

  2. Confirm the printer is in ZPL mode.

  3. Confirm the correct printer driver is installed.

  4. Confirm the printer is a Zebra-compatible label printer.

  5. Try printing a test ZPL label using the printer utility or the QZ Tray demo page.

Browser shows a QZ Tray security prompt

This can happen when your browser connects to QZ Tray.

Approve the QZ Tray prompt to allow ProcureDesk to print.

Note: Silent printing without prompts may require additional QZ Tray certificate or signing configuration.

Setup checklist

Use this checklist to confirm setup is complete:

  • Zebra-compatible label printer is connected.

  • Printer driver is installed.

  • Printer appears in your computer’s printer list.

  • Printer name includes Zebra.

  • Printer supports ZPL.

  • QZ Tray is installed.

  • QZ Tray is running.

  • QZ Tray can detect the printer.

  • Printer appears on https://demo.qz.io.

  • Barcode preview opens in ProcureDesk.

  • Label prints successfully from ProcureDesk.

Quick start

  1. Install the Zebra printer driver.

  2. Confirm the printer appears on your computer.

  3. Rename the printer so the name includes Zebra.

  4. Install QZ Tray from https://qz.io/download/.

  5. Start QZ Tray.

  6. Open ProcureDesk.

  7. Go to Inventory.

  8. Click the printer icon.

  9. Click Proceed To Print.

  10. Approve any QZ Tray prompt if shown.

Did this answer your question?