Flowhub lets you configure receipt printers, label printers, and fulfillment ticket printers directly in the Maui app. In this article, we'll guide you through connecting your printers so your team can print barcode labels, exit labels, receipts, and fulfillment order tickets.
✏️ Note: Before configuring printers in Flowhub, confirm your printers are connected to your computer and printing correctly. You can verify this by printing a test page from a program such as Notes or another word processor. If you are unable to print outside of Flowhub, the issue is with your hardware or printer connection. Flowhub staff is not able to troubleshoot hardware or printer connections. If you purchased your hardware from Venture Sourcing Group, reach out to them directly for assistance. Otherwise, contact the printer manufacturer.
✏️ Note: If your store uses an In-Store Order Fulfillment workflow where order tickets are sent to a back room before payment is collected, you can configure a separate fulfillment receipt printer in the steps below.
Make sure you have the correct Maui app installed for your operating system:
Configure Printers on Mac or iPad
Log into the Maui app on your Mac or iPad.
Do not log into the browser version of Maui (app.flowhub.com).
Select the Printer icon in the upper-right corner, next to the initials of the logged-in user.
A window will display, allowing you to choose your Receipt Printer and Label Printer from the dropdown lists.
If your printers are connected to your computer, they will appear in the dropdown. Select the correct printer for each.
Select Print Test Receipt and Print Test Label to verify that Maui prints each as expected.
The test receipt and test label are default Flowhub versions and do not reflect your dispensary's name or settings.
💡 Tip: If your dropdown displays <NONE>, your printers are not yet connected to the computer. Confirm the connection before continuing.
Configure a Fulfillment Printer on Mac
In the Printer configuration window, select the Fulfillment Printer toggle.
Select your fulfillment receipt printer from the dropdown.
Select Print Test Receipt to verify the fulfillment printer works as expected.
✏️ Note: Fulfillment printer connectivity has been tested with Star Micronics mC-Print3 and TSP100 models via Ethernet, Bluetooth, and USB, as well as shared network printers on macOS and Windows. Connecting to shared printers from Maui is currently supported on macOS and Windows only. iPads cannot connect to a network-shared printer. Contact your IT provider for assistance setting up shared network printers.
Configure a Fulfillment Printer on iPad
In the Printer configuration window, select the Use second printer for fulfillment tickets toggle.
A second dropdown will display for the fulfillment receipt printer.
Select your fulfillment receipt printer from the dropdown.
Select Print Test Receipt to verify the fulfillment printer works as expected.
Great work! 🥳 Your printers are now configured and your team can print barcode labels, exit labels, receipts, and fulfillment order tickets in Maui.
Configure Printers on Windows
Log into the Maui app on your Windows desktop or Microsoft Surface Pro.
Do not log into the browser version of Maui (app.flowhub.com).
On your external keyboard, press the Alt key.
Enable the On-Screen Keyboard (if no external keyboard is available)
If you do not have an external keyboard, enable the Windows On-Screen Keyboard:
Navigate to the Settings menu from the Start bar, or search for Settings on your desktop.
Navigate to Accessibility.
Under the Interaction section, select Keyboard.
Set Sticky Keys to Off and On-Screen Keyboard to On.
Navigate back to the Maui app and use the On-Screen Keyboard to press the Alt key.
Complete Printer Configuration on Windows
After pressing Alt, a menu will display above the Maui app with File, Edit, and Printers.
Select Printers.
The Printer Settings menu will display.
Highlight receipts, then select your receipt printer from the list.
Highlight labels, then select your label printer from the list.
If you use a second receipt printer for fulfillment, highlight Fulfillment, then select your fulfillment receipt printer from the list.
Select Print Test Receipt and Print Test Exit Label to verify that Maui prints each as expected.
The test receipt and test label are default Flowhub versions and do not reflect your dispensary's name or settings.
Troubleshoot Printing Issues on Windows
If you have been able to print as expected but suddenly cannot, you may have multiple instances of the Maui app open at once.
In the Maui app, press F11 (or select Alt > File > Fullscreen) to put Maui in window mode, exposing the Taskbar.
Select the Maui icon on the Taskbar.
If multiple instances of Maui are open, all open instances will display.
If you are taken directly to Maui, only one instance is open. In this case, reach out to Product Support for additional assistance.
Right-select the Maui icon on the Taskbar and select Close all windows.
Troubleshoot Bold or Unreadable Barcode Labels
If your QR codes or barcode labels are printing too dark, thick, or blurry and scanners cannot read them, the issue is likely caused by your printer's dithering setting. Dithering applies a halftone pattern to images, which can cause barcode lines to bleed together and become unreadable. Disabling dithering restores clean black-and-white output so scanners can read your labels reliably.
Disable Dithering on a Zebra Printer
Open the Zebra Setup Utilities application on the computer connected to your label printer.
Select your label printer from the list, then select Configure Printer Settings.
Navigate to the Dithering option and set it to None (or Off, depending on your model).
Select Send or Apply to save the change to your printer.
Print a test label in Flowhub to confirm the barcode is now scannable.
💡 Tip: If you do not have Zebra Setup Utilities installed, you can also adjust dithering through your printer's web interface or by sending a ZPL command. For detailed instructions, refer to Zebra's dithering adjustment support article.
💡 Tip: This fix applies to most Zebra thermal label printers. If you are using a different brand of label printer, check your printer's settings or configuration utility for a similar dithering or image processing option.
If your labels are still printing incorrectly after disabling dithering, reach out to Product Support for additional assistance.
Frequently Asked Questions
Do I need to configure printers on every terminal?
Yes. Printer configuration is per-device in Maui. Each terminal that needs to print must have its printers configured individually.
Can I use the same printer for both receipts and labels?
No. Receipt printers and label printers use different paper sizes and print formats. You need a separate printer for each.
What should I do if my printer does not appear in the dropdown list?
Confirm that your printer is powered on, connected to the computer (via USB, Bluetooth, or network), and that the printer driver is installed. Try printing a test page from another application to verify the connection before returning to Maui.
Can I configure printers in the browser version of Maui?
No. Printer configuration is only available in the Maui desktop app (Mac or Windows) or the Maui iPad app. The browser version at app.flowhub.com does not support printer configuration.
My barcode labels print too dark or bold and my scanner cannot read them. What should I do?
This is typically caused by a dithering setting on your label printer. See the Troubleshoot Bold or Unreadable Barcode Labels section above for steps to resolve this.
Great work! 🥳 Your printers are now configured so your team can print barcode labels, exit labels, receipts, and fulfillment order tickets in Maui, and you're equipped with a few tips and tricks for troubleshooting.