Connecting Printers to Koi

Koi enables you to automatically print Shipping Labels, Pick/Pack Slips, Tax Invoices and Barcodes with the use of a local software client called "Koi Printer Connect". This software is installed on your computer, allowing the Koi web application to connect directly to your printers, eliminating the need to go through various print dialogs and select different printers.

Step 1: Downloading Koi Connect

Koi Connect is available for both Windows and macOS.

You can download Koi Printer Connect from the Printer Settings Page.

Go to Settings by clicking on the ⚙️ Settings gear icon 1️⃣ on the top
Click on the Printing link 2️⃣ to go to the Printing Settings page

Scroll down to the bottom of the Printing settings page until you see the Printing App Downloads section.

Download the version of Koi Printer Connect for your operating system

Once you have installed the Koi Printer Connect, you will be asked to log in.

Step 2: Installing Koi Printer Connect

Drag PrinterConnect into your Applications Folder

Double Click the PrinterConnect app to open the application

On first run you might be prompted to confirm you want to open the app.
Click the Open button to confirm

The PrinterConnect app has the ability to talk to legacy shipping scales that fool your computer into thinking they are a standard USB Keyboard. This functionality requires PrinterConnect to access document and data in System Events.app
PrinterConnect also needs to be able to connect to the Printers connected to your computer.
Click the OK button to enable this.

The PrinterConnect app needs you to be signed-in to work, we will do this next.

Step 3: Logging Into Koi Printer Connect

⚠️ Koi Printer Connect requires different login details

The login details for Koi Printer Connect are not the same as those for your Koi Account. These details are shared by everyone who uses your business' Koi Account, and are not specific to any one user. This means that multiple users on different devices can access the same printers, and you can even print from your mobile device.

To access your PrinterConnect login credentials:

Go to Settings by clicking on the ⚙️ Settings gear icon 1️⃣ on the top
Click on the Printing link 2️⃣ to go to the Printing Settings page

Scroll down until you see the section titled Print Client Login.

Copy and paste the Username 1️⃣ and Password 2️⃣ from the Koi Web application into the Koi Connect App and then click the Sign In 3️⃣ button.

☝️ Not seeing the Printer Connect Window?

On your computer select the PrinterConnect app menu bar icon 1️⃣
and then click the Sign in 2️⃣ menu item

Once you have Signed into the PrinterConnect app successfully you will see the following window:

After a few minutes the various printers connected to your computers with the Koi Printer Connect app running on them will be visible on the Printer Settings Page.

Step 4: Assigning Printers to Different Roles

You can assign printers to different roles on the Printer Settings Page.

On this page, you can tell Koi which printer to use for what and what label media the printer is using. Koi segments your printers into: "Small Thermal" for printing product labels and warehouse location barcodes; "Medium Thermal" for printing manual shipping address labels (e.g. the kind of address label you'd find on a letter); "Large Thermal" for printing carrier shipping labels; and "Desktop Printer" for printing Pick/Pack Slips, Quotes and Tax invoices.

To assign a printer to a specific role, select the printer from the dropdown 1️⃣ .
Select the most printing label or media 2️⃣.
Click the Save button 3️⃣.

Step 5: Testing Printers Connected to Koi

You can test your printers connected to Koi by clicking the Test button next to each kind of printer.