USB Printer Setup 🖨️

ShopkeeperPOS Desktop supports direct USB printer connections, making it easy to print receipts and invoices right from your desktop application. This guide will help you set up and configure your USB printer.

Desktop Feature: USB printer support is available only in the desktop application. This feature requires a physical USB connection to your printer.

Prerequisites

Before you begin, make sure you have:

  • A USB-compatible printer (thermal or standard)
  • A USB cable to connect your printer to your Mac
  • ShopkeeperPOS Desktop application installed
  • Printer drivers installed (if required by your printer)

Connecting Your Printer

Step 1: Physical Connection

  1. Turn on your printer
  2. Connect the USB cable from your printer to your Mac
  3. Wait for your Mac to recognize the printer (you may see a notification)

Step 2: Configure in ShopkeeperPOS

  1. Open ShopkeeperPOS Desktop
  2. Navigate to Settings → Printer Settings
  3. Click "Detect Printer" or "Scan for Printers"
  4. Select your printer from the list of detected printers
  5. Click "Test Print" to verify the connection
  6. If the test print works, click "Save"

💡 Tip

Tip: If your printer doesn't appear in the list, make sure it's turned on and properly connected. You may need to restart ShopkeeperPOS Desktop after connecting the printer.

Printer Settings

Once your printer is connected, you can configure:

  • Paper Size: Set the receipt paper width (58mm, 80mm, etc.)
  • Print Quality: Adjust print density if needed
  • Auto Print: Automatically print receipts after each sale
  • Print Preview: Show preview before printing

Printing Receipts

After setup, printing receipts is easy:

  1. Complete a sale in the Sales module
  2. After payment, click "Print Receipt" or "Print Invoice"
  3. If auto-print is enabled, the receipt will print automatically

Troubleshooting

Printer Not Detected

If ShopkeeperPOS can't find your printer:

  • Check that the USB cable is securely connected
  • Make sure the printer is turned on
  • Try unplugging and reconnecting the USB cable
  • Restart ShopkeeperPOS Desktop
  • Check if the printer appears in macOS System Settings → Printers

Print Quality Issues

If prints are too light, too dark, or misaligned:

  • Adjust the print density in Printer Settings
  • Check printer paper alignment
  • Clean the printer head (refer to your printer manual)
  • Try a test print to verify settings

Printing Blank Receipts

If receipts print but are blank:

  • Check that you've selected the correct printer
  • Verify the printer has paper loaded
  • Try printing a test page from macOS System Settings
  • Check printer settings in ShopkeeperPOS

⚠️ Important

Important: Always test your printer connection before processing sales. A test print ensures everything is working correctly and helps avoid issues during busy periods.

Supported Printers

ShopkeeperPOS Desktop works with most USB thermal and standard printers that are compatible with macOS. Popular compatible printers include:

  • Epson thermal printers
  • Star Micronics printers
  • Bixolon printers
  • Most standard USB printers
Not sure if your printer is supported? Try connecting it and running the detection scan. If it appears in the list, it should work with ShopkeeperPOS Desktop!

Printer Events

ShopkeeperPOS Desktop automatically detects when:

  • A printer is connected (you'll see a notification)
  • A printer is disconnected (you'll be notified)
  • Print jobs are completed or fail

These notifications help you stay aware of your printer status and troubleshoot issues quickly.