Skip to main content

Receipt Printer Settings

Connect your receipt printer and control when and how receipts, bag tags, and labels print.

Written by Rafael

Go to More > Hardware > Receipt Printer.

What is the receipt printer?

The receipt printer is the thermal printer at your counter. It prints customer receipts and store copies for each order. It can also print laundry bag tags and bags out labels, and it can open your cash drawer when the drawer is plugged into it.

Hardware settings are saved per station. Set up the receipt printer on each station that has one.


Connect a printer

If no printer is connected, the page opens a setup wizard.

  1. Select your manufacturer: CleanCloud, Star Micronics, Epson, Citizen, or Bixolon.

  2. Select your model. For Star, choose TSP100 (futurePRNT), mC-Print3, or Other / not listed.

  3. Select the connection: USB, Ethernet / LAN, or Bluetooth.

  4. Connect the printer and power it on.

  5. Install the driver. Select Download, or Skip if it is already installed.

  6. Install QZ Tray. Select Download QZ Tray. Continue stays disabled until QZ Tray is detected. See How to set up QZ Tray.

  7. Select Continue.

Select Back to return to a step, or Get help if you are stuck.


Printer Setup

Shows the printer connected to this station, with its manufacturer, model, and a status dot.

  • Print Test Receipt: Prints a sample receipt. Use it after setup, or whenever you want to check the printer is working.

  • Change: Connects a different printer. Use it if you replace your printer or switch the connection type.


Receipt Settings

These settings decide when a receipt prints and which copies you get.

  • Auto Print Receipt: Prints a receipt automatically when an order is created. Choose No to print manually, Yes to always print, or Yes - except Retail Orders to skip receipts for retail-only sales.

  • Auto Print Receipt if Pay on Pickup: Prints a receipt automatically when an order is paid at pickup. Turn it on if you want a receipt at the counter when the customer collects.

  • Receipt to Print for New Order: Chooses which copy prints for a new order. Print Customer copy only gives the customer a receipt. Print Store copy only gives your team a copy. Print Customer copy and Store copy prints both.

  • Print Summary Receipt on Batch Payment: Prints one summary receipt when you take payment for several orders at once, instead of one receipt per order.

  • Print Separate Store Copies for Each Section: Prints a separate store copy for each section of the order, so each part of your plant gets its own copy.

  • Print Extra Store Copy: Prints one more store copy. Use it if you keep one copy with the order and one at the counter.

  • Print Extra Customer Copy: Prints one more customer copy. Use it if you give customers two receipts.

  • Auto Print Laundry Bag Tags: Prints a tag for each laundry bag when an order is created. The tag helps your team match each bag to its order.

  • Print Bags Out Labels: Prints a label for each bag going out, so bags are easy to identify when customers collect them. You can print these on this printer or on a label printer, see Label Printer Settings.


Receipt Format

These settings change what the receipt looks like.

  • Paper Width: Matches the receipt to your paper roll. Choose Normal (76mm) or Narrow. If text is cut off or very small, check this setting.

  • Show Prices for Items: Shows the price of each item on the receipt. Turn it off if you do not want prices to print.

  • Show Unit Prices for Items: Shows the price per unit for each item, for example the price per pound or per piece.

  • Include Upcharge in Product Price: Adds upcharges into the item price instead of listing them as separate lines. Turn it on for a shorter, simpler receipt.

  • Print Barcode: Prints an order barcode at the bottom of the receipt. Your team can scan it to find the order or rack it.

  • Print QR for E-Receipt: Prints a QR code on the customer copy. Customers scan it with their phone to open their e-receipt.

  • Print Receipt as Image (Arabic): Prints the receipt as a picture instead of text. Turn it on if Arabic characters print wrong, as boxes, question marks, or in the wrong order. It also helps for other languages your printer cannot print as text.

  • Custom Text on Receipt: Adds a message that prints on every receipt, such as a thank you or a policy.


QZTray Version

QZTray Version shows the version CleanCloud uses to talk to your printer. Choose 2.0, 2.1, or 2.2. Leave it on the default unless Support tells you to change it. See How to set up QZ Tray.


Common questions

Why do Arabic characters print as question marks or boxes?

The printer cannot print those characters as text. Turn on Print Receipt as Image (Arabic).

I installed my printer after QZ Tray and it is not found. What do I do?

Quit QZ Tray from the system tray and open it again so it picks up the new printer.

My browser asks for permission to access other apps and services on this device. What do I choose?

Select Allow. If you chose Block before, open your browser’s site settings, set Apps on device to Allow, and refresh the page.

QZ Tray does not work in Firefox. What should I use?

Use Google Chrome or Microsoft Edge.

Can I use a Star TSP100 on a Mac?

No. Use a Star mC-Print3 on Mac, Chromebook, or Linux.

The driver will not install. What can I try?

Download the driver-only file for your exact model from the manufacturer and unzip it. In your computer’s printer settings, open the printer Properties, go to the Driver tab, select Update Driver, and point it to the unzipped folder.

Why is there no barcode or QR code on my receipt?

Turn on Print Barcode or Print QR for E-Receipt. Both only print on a thermal receipt printer, not on garment tag, laser, or inkjet printers.

Why does the e-receipt QR code not open anything?

The customer scans it with their phone camera. It opens the e-receipt for that order. If it does not scan, check that the receipt printed clearly.

Do tips print on receipts?

Yes, when you turn on tips in your store settings and enter a tip on the order.

Can I add my logo to receipts?

Yes. On Star printers the logo is stored in the printer using Star’s configuration utility on Windows.

My Ethernet printer loses its connection. What should I do?

Give the printer a static IP address on your network, so it keeps the same address every time it is powered on.

Where do laundry bag tags and bags out labels print?

Bag tags print on the receipt printer. Bags out labels print on the receipt printer or on a label printer, see Label Printer Settings.

Can I use a different printer on each station?

Yes. Each station has its own printer settings.

Did this answer your question?