Technical Assistance


Receipt Printer Configuration - Get Started


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

Note: Star TSP100 printers must configure in Epson ESC/POS mode for cash drawer and receipt cutting functionality.


  1. Connect your printer and/or cash drawer to your PC
    • 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.
    • For connecting directly via serial, see the "Connecting a Serial Printer in Windows" section at the bottom of the page.
    • Cash drawers can be plugged directly into the PC, or more commonly, they are plugged into the receipt printer, which is plugged directly into the PC.
  2. Install the QZ Tray App
    • Make sure you have the QZ Tray App installed, please view QZ Tray App 2.0 to install.
  3. Configuring CivicRec
    1. In CivicRec, navigate to Configuration > Peripherals > Receipt Printer Configuration 
      • You will have to grant permission to the QZ Print Plugin. Use the Always Allow option so the plugin won't be blocked.
    2. Enter the name or partial name of the printer as it appears in "Devices and Printers" in Windows
      • If set up correctly, Rec1 will now be able to recognize your printer.
    3. Select Global Settings >Test Printer Connection
    4. 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 and try printing a test receipt.
      • It should print to the set specifications.

Use in CivicRec

  1. 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. When it opens for the first time, you'll have to make sure to allow all popups from... or CivicRec won't be connected to the receipt printer
  2. In Configuration > Peripherals > Receipt Printer Configuration; you can print a test receipt by going to Local Settings > Print Test Receipt
    • You will also have the cash drawer pop open, and a receipt printed when a POS transaction is completed.
    • In the full checkout process (program registration or facility rental), a receipt will print once the transaction is completed.
    • For more information on configuring receipt printer and cash drawer hardware please visit our configuring receipt printer and cash drawer hardware article.

Connecting a Serial Printer in Windows

Add a "generic / text only" printer named CivicRec for compatibility and/or serial printers.
  1. Navigate to Start > Control Panel in the left have corner of the screen
  2. Access Hardware/Printers section 
  3. Select Add a Printer 
  4. Set the printer as a local printer
  5. You will then have a drop-down menu for what port the printer is on. 
    For serial: This should be set to COM1.
  6. When you get to the screen to select manufacturer/printer, leave it on Generic/Text Only and select next.
  7. Make sure not to make it your default printer, it doesn't need to be shared, and you don't need a test page.
  8. The name of the printer should be CivicRec. 
    • You should now see a printer in your printer list called "CivicRec".
  9. Follow the first set of steps using the printer name CivicRec.
Note: Global Settings are stored in the CivicRec database, so they will never be reset. Local Settings are stored as a "cookie" and can be reset if you clear your browser history/cookies. We advise that everyone configure their printers the same way on all machines so that Global settings are used and local are not.

Cash Drawer Command Setup for Windows

In order to assure that the printer is sending a cash drawer kick command, do the following:
  1. Open Printers and Faxes (or Devices and Printers in Windows 7); in Windows XP, select Start
  2. Select Run, search control printers, then press Enter; in Windows Vista or Windows 7, select Start, search control printers, and press Enter
  3. In Windows XP or Windows Vista, right-click your printer, select Properties, then select Printing Preferences; in Windows 7, right-click your printer, select Printer Properties then select Printing Preferences
  4. Select the Document Settings tab
  5. Select Cash Drawer; set both cash drawers to open before printing
  6. Select OK
  7. Select the General tab
  8. Select Print Test Page
  9. Your cash drawer should open upon printing; if it does not, you may wish to troubleshoot cash drawer connectivity

I'd Like to Request an Enhancement

0 out of 0 found this helpful


Article Feedback