Technical Assistance


Configure Receipt Printer and Cash Drawer

Note: Before following this process, ensure your hardware is configured properly by following the steps in the Receipt Printer Configuration article.


CivicRec can print/cut thermal receipts using your receipt printer and open POS cash drawers. To do this, we use a Java plugin that prints directly to your receipt printer and/or cash drawer.


Step 1: Connect your printer and/or cash drawer to your PC

  1. For USB printers, make sure it is connected and you installed the drivers from the manufacturer (either by cd or downloaded). The printer should be visible in "Devices and Printers" in Windows.
  2. For connecting directly via serial, see the "Connecting a Serial Printer in Windows" section at the bottom of the page.
  3. Cash drawers MUST be plugged into a receipt printer via RJ11 or similar connection. Supported receipt printers can be plugged directly into the PC via serial or USB.


  1. Make sure you have the latest version of Java installed, available at
  2. Most current customers the QZ print app, either by java applet or tray app. However, the new USB-hid-QZ tray app is our recommendation for all. It's a better solution all the way around. To download the QZ Applet
  3. The QZ tray is out for Mac OSX. You can download the QZ Tray App at their site. Version 2.0  is the newest version, Version 1.9 is no longer supported. Click "Show All Systems" to see the Mac version. Safari will not work with the Java version, as Java is no longer supported by it. Internet Explorer is the only way to use the Java version, and using the QZ tray app is the modern, more reliable method.

Step 3: Configure CivicRec

  1. In CivicRec, navigate to Configuration > Peripherals > Receipt Printer Configuration
  2. Connect to the QZ Print Plugin
  3. Enter the name or partial name of the printer as it appears in Devices and Printers in Windows.
  4. If set up correctly, CivicRec will now be able to recognize your printer.
    • Note: Click Test Printer Connection. It should print a test line and pop your cash drawer.
  5. Ensure the Characters Per Line setting is set to match the specifications for your model of the receipt printer
  6. Select Save Global Settings

Step 4: Use in CivicRec

CivicRec uses a pop-up window that you can minimize in the background to stay connected to the receipt printer. This makes printing receipts extremely fast from the browser. 

  1. In Point-of-Sale, you can print a test receipt by going to Options / Print Test Receipt. You will also have the cash drawer pop open, and a receipt printed when a POS transaction is completed.
  2. In the full checkout process (program registration or facility rental), a receipt will print once the transaction is completed.

Connect a Serial Printer in Windows

Add a "generic / text only" printer named CivicRec for compatibility and/or serial printers.

  1. Access the Printers section in the computer's control panel.
  2. Click "Add a Printer" and set the printer as a "local printer".
  3. You will then have a drop-down menu for what port the printer is on. 
    For serial: This should be set to COM1.
  4. When you get to the screen to select manufacturer/printer, leave it on "Generic / Text Only" and just click next.
  5. Make sure not to make it your default printer, it doesn't need to be shared, and you don't need a test page.
  6. The name of the printer should be CivicRec. You should now see a printer in your printer list called "CivicRec".
  7. Follow the first set of steps using the printer name CivicRec.

I'd Like to Request an Enhancement

0 out of 0 found this helpful


Article Feedback