We are excited to announce the launch of updated product names, logos, and headers within our user interfaces as part of the CivicPlus® Solution Rebranding initiative. These changes mark the first step toward creating a cohesive and seamless user experience across all solutions in our portfolio. As part of this transition, users may notice minor design updates. While the functionality you rely on remains unchanged, we are in the process of updating screenshots and other resources on our Help Centers to reflect the new branding. We appreciate your patience and understanding as we work to complete these updates.
Receipt Printer / QZ Tray Troubleshooting
Updated:
There are three items to troubleshoot:
Receipt printer's drivers, settings, and connection to the computer
Note: If the printer physically connects to another computer, then this would be a network printer. The IT Department should troubleshoot in this case.
Printer Drivers download from the Printer manufacturer's website
Review printer settings
Once you check or can complete a test print, move on to Task 2.
Task 2: QZ Tray
3 common issues:
QZ Tray is not set to automatically start
QZ Tray is not installed
Issues with the installation of the Tray
Note: You can remove and install the QZ Tray to resolve installation issues. If there is a consistent issue that this cannot solve, then that is an issue that your IT department must resolve.
Additional Resources
If You Experience This
Try This
The printer connects with USB and shows online/active on Windows Printers/Devices screen, but Recreation Management does not respond when you click Test Printer Connection
Ensure QZ tray app 2.0 is running and that no other versions of the QZ tray app are installed
Ensure QZ tray app does not have CivicPlus blocked in the Site Manager (QZ Tray Icon in the bottom right, click Advanced, click Site Manager)
Ensure you use Google Chrome or IE11+ (Websockets do not work in earlier versions of IE)
The printer does not show online/active status on the Windows Printers/Devices screen
Ensure the printer is plugged into a known working USB port and is powered on
Try power cycling the printer and/or plugging it into a different USB port.
If the printer shows as an Unknown Thermal Device or similar device (not as a printer), ensure the correct drivers were installed for the printer (they usually come with a CD).
If the printer shows a connection but is " faded out", indicating it is offline, try to change the USB port to USB002 or USB001 in the Ports tab of the printer settings
The printer is Serial or uses a USB/Serial adapter
Ensure a generic/text printer is added in Windows, pointing to COM4 (Port tab of printer settings). Sometimes it may be COM1.
Ensure that Recreation Management tests do show up in the print queue.
A print action from Recreation Management shows in a print queue but does not print.
Ensure the printer points to the correct port
Ensure the printer has the driver installed (if USB)
Recreation Management says Printer found: Null or Printer not found
Ensure the printer name in Recreation Management matches the name of a printer in Windows
Fully restart the QZ tray by exiting and re-opening it, then refresh the Recreation Management receipt printer configuration page
IE11: Could not connect to printer tray application
Ensure that CivicPlus is Allowed by the QZ Tray Site Manager
Go to IE's Internet Options screen, then navigate to the Security tab, choose Intranet, and click the Sites button.
Ensure the first two checkboxes are unchecked and the last two are checked, then save the settings. Then refresh the receipt configuration page, and it should get a successful connection to the tray application.
In-Article Glossary
Review the Help Center Glossary, a comprehensive explanation of the acronyms, abbreviations, and company-specific terminology. The terms located in this section are listed alphabetically:
IT: Information Technology
PC: Personal Computer
Comments
Let us know what was helpful or not helpful about the article.
Comments
Let us know what was helpful or not helpful about the article.0 comments
Please sign in to leave a comment.