When Fresh KDS is set up as a printer in Square, it uses the local network to receive orders from your POS.

Unable to connect Fresh KDS with Square if using Printer Emulation? Try this!


Before you begin, please confirm:

  • POS is Square POS/Register, and Integration Type is Printer Emulation.
    From the Fresh KDS app, navigate to Settings - General.

    • Point of Sale System: Square POS/Register

    • Integration Type: Printer.
      *If using Square for Restaurants, refer here, or if using Square with Orders API, refer here.

  • Fresh KDS and Square POS are connected to the same Wi-Fi network.
    Fresh KDS will not work if you use your Square device as a hotspot.

  • Fresh KDS App is up to date.
    Check the latest version (and release notes) here.

  • Square POS is up to date.


Step 1: Restart your KDS tablet, Square POS, and Router to refresh the connection.

Fresh KDS will only broadcast as a printer if the KDS App is open. Minimizing the app, powering the tablet off, or allowing it to go into sleep mode will temporarily break the connection with your POS.

💡 Network connectivity issues? Try this.


Step 2: Confirm Fresh KDS is set up as a Printer Station in Square.

  • From your Square app, tap ‘More’ on the bottom navigation bar.

  • Navigate to Settings - Hardware - Printers.

  • Fresh KDS will be listed under ‘Printer Model.’

See your KDS?

Tap 'Print Test' to verify the connection.
If a test ticket appears, confirm the following are enabled under ‘Use This Printer For:’

  • In-person order tickets - ‘On.’

  • Categories to print - Confirm all correct categories are selected.

Don’t see your KDS?

Allow the Fresh KDS app to access your Local Network.

  • iOS: Navigate to Settings - Privacy.

    • Select 'Local Network.'

    • Toggle on for Fresh KDS and your POS.

Turn off Private Address on your device's Wi-Fi settings.

  • iOS: Navigate to Settings - Wi-Fi.

    • Select the 'Information (I)' icon of your connected network.

    • Toggle off for Private Address.

  • Android: Navigate to Settings - Connections - Wi-Fi.

    • Select the 'Cogwheel' settings icon of your connected network.

    • Select 'Advanced' to open the dropdown menu.

    • Select the option for 'MAC Address Type' and set it to 'Device MAC.'

Next, follow these configuration steps to add Fresh KDS as a Printer Station in Square:

  1. From your Square app, tap ‘More’ from the navigation bar at the bottom of your screen.

  2. Navigate to Settings - Hardware - Printers.

  3. Select ‘Create Printer Station.'

  4. Enter a Printer Station Name.

  5. Select ‘Printer’ and select ‘Fresh KDS.’
    *Confirm the following are enabled under ‘Use This Printer For’

    • In-person order tickets - ‘On.’

    • Categories to print - Confirm all correct categories are selected.

  6. Tap ‘Test Print’ to verify the printer connection.

  7. Tap ‘Save’ to complete the printer setup.

💡For additional support with Square Printer Stations, please refer to the Square Help Guide.


Display Support For Square Printer Emulation Orders

Confirm the Order Type assigned to (new) sales in Square:

  1. On your Square POS - Under Review Sale/Checkout, the Order Type (Square dining option) will display at the top.

  2. The default dining option is automatically applied.

  3. To change it, swipe your finger left over the default option.

💡For additional support with Square Dining Options, please refer to the Square Help Guide.


Confirm Order Types are turned on for display in Fresh KDS:

  1. From your Fresh KDS App, Tap to click on Settings - Display Modes.

  2. Toggle On for all applicable Order Types.

Fresh KDS Display Modes of Order Types

Still no luck?

Contact our support team using the message icon at the bottom right of your screen, or email us directly at help@freshkds.com.

Did this answer your question?