Troubleshooting
Receipt Printer Issues
Section titled “Receipt Printer Issues”I can’t find my receipt printer model in the pre-configured models
Section titled “I can’t find my receipt printer model in the pre-configured models”Use a similar model or one from the same brand. You can also try a generic model.
My printing is slow
Section titled “My printing is slow”Use direct mode instead of image mode in the print settings.
Some characters are not printing correctly
Section titled “Some characters are not printing correctly”This is normal; printers only use a fraction of what your screen can display. You need to use image mode in the print settings.
In image mode, the content is cut off
Section titled “In image mode, the content is cut off”You must ensure that you have correctly filled in the DPI and width fields in the settings.
The padding settings are not respected
Section titled “The padding settings are not respected”There are internal padding settings in the machine. Test and find the parameters that work best for you.
In direct mode, font sizes are very large when printing
Section titled “In direct mode, font sizes are very large when printing”In the case of direct mode printing, we cannot configure the font size directly. This configuration is in the printer. Please refer to your printer’s user manual.
Star Micronics on macOS
Section titled “Star Micronics on macOS”My Star Micronics printer doesn’t print anything on macOS
Section titled “My Star Micronics printer doesn’t print anything on macOS”Star Micronics printers are not compatible with direct ESC/POS commands on recent versions of macOS (13+). Use the Receipt Printer (Mac Alternative) mode instead:
- Go to Settings → Printing
- Select Receipt Printer (Mac Alternative) from the Mode dropdown
- Select your printer from the list
- Configure the image settings as needed
See Receipt Printer (Mac Alternative) Configuration for detailed setup instructions.
My Star printer prints garbled characters on macOS
Section titled “My Star printer prints garbled characters on macOS”This is a driver compatibility issue with recent macOS versions. Switch to Receipt Printer (Mac Alternative) mode which bypasses the direct driver communication.
The bottom padding is being cut off
Section titled “The bottom padding is being cut off”The print system may automatically trim blank margins from images. Enable the Prevent Trim option in the Receipt Printer (Mac Alternative) settings to add a thin line that prevents this trimming.
Cross-Platform Compatibility
Section titled “Cross-Platform Compatibility”Which printer brand works on all operating systems?
Section titled “Which printer brand works on all operating systems?”Epson printers are the only brand that works correctly on Windows, macOS, and Linux with the standard Receipt Printer mode. If you need a printer that works seamlessly across all platforms without workarounds, we recommend the Epson TM-T20III or similar models.
My printer works on Windows but not on macOS
Section titled “My printer works on Windows but not on macOS”This is common with Star Micronics printers. Use the Receipt Printer (Mac Alternative) mode on macOS while continuing to use the standard Receipt Printer mode on Windows.