Articles on: Daily Operations

Printing Receipts With a Thermal Printer

CloudBridal supports printing payment receipts directly to thermal receipt printers (80mm paper). This feature allows for faster receipt printing and a more professional checkout experience.


Browser Requirements


Thermal receipt printing requires a browser which supports WebUSB, an experimental feature only available in the following browsers:


  • Google Chrome
  • Microsoft Edge


Printer Compatibility


CloudBridal uses ESC/POS commands, the industry-standard protocol for thermal receipt printers. If you already have a compatible printer, you should be able to use it with CloudBridal. If not, we recommend the Epson TM-T20III as this is the printer we use for testing.


Paper Requirements

  • Width: 80mm thermal paper
  • Type: Standard thermal receipt paper


Note: While CloudBridal uses the standard ESC/POS protocol, some printer-specific features may vary. We recommend testing with your specific printer model to ensure full compatibility.


Hardware Setup


Windows Setup

Windows requires the Zadig driver tool to enable WebUSB communication with thermal printers:


  1. Download Zadig: Visit zadig.akeo.ie and download the latest version
  2. Connect your thermal printer via USB to your computer
  3. Run Zadig as administrator
  4. Enable device listing: Go to Options → List All Devices
  5. Select your printer from the dropdown (e.g., "TM-T20III")
  6. Install WinUSB driver: Click the Replace Driver button to install the WinUSB driver




Mac Setup

Mac systems typically work with thermal printers out of the box without additional driver installation.


CloudBridal Configuration


Before you can print thermal receipts, you need to enable the feature:


  1. Navigate to Payment Settings
  2. Find the Thermal Receipt Printing section
  3. Enable Enable Thermal Receipt Printing
  4. (Optional) Add Custom Header Text
  5. (Optional) Add Custom Footer Text


Printing a Receipt


Once your thermal printer is set up and the feature is enabled:


  1. Create or select a payment from the customer's profile
  2. Open the print page by clicking the print receipt button for the payment.
  3. Connect to your printer: Click Connect & Print Thermal Receipt
  4. Select your device from the browser's device selection dialog (e.g., "TM-T20III - Paired")
  5. Click Connect to establish the connection
  6. The receipt will automatically print to your thermal printer


The system will remember your printer selection for future print jobs during the same browser session.


Troubleshooting


Printer not appearing in device list?

  • Ensure the printer is connected via USB and powered on
  • On Windows, verify the WinUSB driver was installed correctly using Zadig
  • Try refreshing the page and attempting the connection again


Print job fails?

  • Verify you are using the latest version of Chrome or Edge
  • Check that the printer has paper and is ready to print
  • Verify the USB connection is secure
  • Ensure your printer supports ESC/POS commands
  • Restart your browser and try again


Partial printing or formatting issues?

  • Some older or specialized printers may have limited ESC/POS command support
  • Try printing a test receipt to verify compatibility


Note: Thermal receipt printing works alongside regular paper receipt generation. You can still print or email receipts as needed for record-keeping or customer preferences.

Updated on: 13/07/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!