QZ Tray is a free app that lets the CleanCloud POS talk to the printers connected to your computer, through your web browser. You need it to set up a receipt printer, garment tag printer, label printer, or heat seal printer, and to open a cash drawer.
Install QZ Tray on every computer that has a printer connected.
How to install QZ Tray
Download the latest version of QZ Tray from qz.io/download. You can also select Download QZ Tray in the printer Setup Wizard.
Open the downloaded file to start the installer.
Select Next.
Choose where to install it. We recommend keeping the default location.
Select Install.
When the installation finishes, QZ Tray is on your computer.
How to check that QZ Tray is running
Look for the QZ Tray logo in the system tray at the bottom right of your screen. If you don’t see it, select the up arrow to show hidden icons.
If it isn’t running:
Open your computer’s search bar.
Type QZ Tray and open it.
Tip: Right-click the QZ Tray logo and make sure Automatically Start is selected. QZ Tray then starts whenever your computer does, so your printers keep working after a restart.
How to connect your printer to CleanCloud
Keep QZ Tray running while you follow these steps.
Go to More > Hardware.
Select the device you want to set up, for example Receipt Printer.
Select Setup Wizard and follow the steps. In the QZ Tray step, Continue turns on once the POS can see QZ Tray.
When a pop-up asks for permission to connect to QZ Tray, select Allow.
Select Remember this decision first, so you aren’t asked again.
For printers set up without the wizard, such as Heat Seals, select Find Printers instead.
Your printer is now ready to use with CleanCloud.
Common questions
Why do I see “Failed to connect to printer”?
Why do I see “Failed to connect to printer”?
The message says “QZ Tray connection failed. Is QZ Tray running?” It means the POS can’t reach QZ Tray. Check that QZ Tray is installed and running on this computer, then try again. If it keeps appearing and you don’t use a printer on this computer, you can ignore it.
Why is Continue greyed out in the Setup Wizard?
Why is Continue greyed out in the Setup Wizard?
Continue stays off until the POS detects QZ Tray. Install QZ Tray, make sure it’s running, then go back one step and return.
Why does the Allow pop-up keep appearing?
Why does the Allow pop-up keep appearing?
You didn’t select Remember this decision. Select it the next time the pop-up appears, then select Allow.
Do I need QZ Tray on every computer?
Do I need QZ Tray on every computer?
Yes. Install it on each computer that has a printer connected, and set up that printer on that computer.
Do I need QZ Tray for the Driver App?
Do I need QZ Tray for the Driver App?
No. The Driver App connects to mobile printers directly.