When Fresh KDS is set up to use Orders API with Square, it uses a Cloud API connection to receive orders from your POS.

⚠️ Please note: The API integration displays all Order Types from your POS as 'For Here,' with the exception of Online Orders. API also does not support using Open Tickets with Square.

Unable to connect Fresh KDS with Square if using Orders API? Try this!


Before you begin, please confirm:

  • POS is Square POS/Register, and Integration Type is Orders API.

    From the Fresh KDS app, navigate to Settings - General.

    • Point of Sale System: Square POS/Register
      *If using Square for Restaurants, refer here, or if Square is set up as a printer, refer here.

    • Integration Type: Orders API.
      Don't see Orders API? Jump down to Step 2.

  • Fresh KDS is connected to the internet.

  • 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.

The KDS Cloud icon will be crossed out when the Fresh KDS app is not connected to our services.

Fresh KDS will only broadcast orders 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.

Fresh KDS Offline / Online Connection

💡 Network connectivity issues? Try this.


Step 2: Confirm the Brand Integration is set up.

  1. Log into your Fresh Dashboard.

  2. Select ‘Brand Integrations’ on the left navigation bar.

  3. Select ‘Edit’ for your Square Brand Integration.

  4. Confirm ‘KDS Orders’ and ‘Menus’ are selected.

  5. Click ‘Update.’

Fresk KDS Brand Integration setup

Step 3: Confirm the POS Integration is set up. (Menu is uploaded & set to autosync.)

  1. Log into your Fresh Dashboard, and select ‘Let’s Go’ for Fresh KDS.

  2. Select ‘POS Integrations’ on the left navigation bar.

  3. Confirm your location is correct.

    • If your location does not appear, select ‘Attach A Location’ and add it.

    • If your location does appear, select ‘Edit’ and confirm the correct Square location populates.

  4. Select ‘Menu Settings.’

    • If your menu does not appear, select ‘Add A Menu’ and add it.

    • If your menu does appear, select ‘Edit’ and confirm menu categories are not excluded from the menu import.

  5. Select ‘Menu Sync.’

  6. Click ‘Sync’ for your menu.

  7. Select ‘Set AutoSync’ and enter a daily automatic sync time.
    *Optional, but recommended.

Fresh KDS Menu Sync

Step 4: Confirm Routing is enabled.

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

  2. Toggle on/off by Category.

  3. Toggling off will temporarily disable the display of selected menu categories on this screen.

Fresh KDS Category Routing

Step 5: 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.


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?