Troubleshoot the Square Kiosk app | Square Support Center (2024)

If you encounter a request to update your Point of Sale apps during the Kiosk setup process on Dashboard, follow the steps below to resolve.

All Square Point of Sale apps must be updated to their latest version. This includes Square Point of Sale, Square Restaurants, Square Retail, etc.

Update the Square apps from the App Store:

1. Open the App Store.
2. Scroll down to see pending updates.
3. Tap Update All to update all apps on your device, or locate your Square apps individually and tap Update.

Once you have updated your Square apps be sure to sign out and sign back into the apps.

The Square apps on Square Terminal and Square Registered are automatically updated during the device’s software update.

You can update software on Square Terminal or Square Register by following these steps:

1. Tap ≡ More > Settings > Hardware > General.
2. Tap About Square Terminal or About Square Register.
3. Tap Check for Update to see if a software update is available.
4. If it is available, tap Install Now.

Once you have updated your Square Terminal and Square Register be sure to sign back into the device.

If the request to update your Square apps and Square devices in your Dashboard does not list the specific apps and devices that need to be updated, follow these steps:

1. Click view all points of sale in the corner of the update request or navigate to Device Management > Devices.
2. Select a device from the list and check the software version under Applications used.
3. If the version is 6.46 or higher, then it is updated. If not, perform the necessary updates.
4. When all updates are complete, navigate back to Device Management > Kiosk and click Done updating devices in the update request window.

To set up Square Kiosk, you’ll need to update to the latest Categories experience. In this update, Square Online site categories will sync with Point of Sale. This will allow you to easily manage in-person and online sales categories from one place.

Note: This update is only required for those who have a Square Online site and have not already been auto-enrolled in the Advanced Categories update. If you do not see this step during your Kiosk set-up, then it is not required.

To update to Advanced Categories:

1. Click Update now in the window that appears during the Kiosk set up on Dashboard.
2. In the next window, click Move Site Categories.
3. Updating and transferring your online categories may take several minutes to complete. If the loading page does not automatically refresh after 30 minutes, you can manually refresh your internet browser.
4. Once your categories have been updated successfully, you will be taken to the next step in setting up your Kiosk menu.

If your kiosk menu has over 100 items, your customers may get overwhelmed and experience difficulty in scrolling through a long list of items. For best performance, we recommend that your kiosk menu doesn’t exceed 100 items. If it does, you may experience a slower performance with the self-serve Square Kiosk app.

To solve this issue, follow the steps outlined in our Square Kiosk menu items and categories guide to reduce the number of items that appear on your menu.

Note: It can take up to 10 minutes for item edits to update across all of your devices.

If you notice the changes you’ve made on your Square Dashboard have not synced to your Square Kiosk app within 10 minutes, follow these steps:

1. Refresh the Kiosk app by clicking Start new order or by closing the app and reopening.
2. Check the connection of the hardware running the Square Kiosk app. On the Square Kiosk app, press and hold two fingers on the screen to open the Settings menu. Tap Hardware > Test connectivity. If needed, troubleshoot your network connection.
3. Restart your hardware. On the Square Kiosk app, press and hold two fingers on the screen to open the Settings menu. Tap Hardware > Connect and manage > Restart.
4. Force quit the Kiosk app. You may need to first disable Guided Access.
5. Open the Kiosk app and sign in again.
6. On your Square dashboard, make a change on your Kiosk menu and wait up to 10 minutes for the update to appear on the kiosk.

If you have completed all steps above and are still experiencing issues in syncing your kiosk menu, please contact Square support and we will help get you back to business.

If you are missing an item that was added to your kiosk menu, follow these steps:

1. Make sure you wait up to 10 minutes for the changes to sync from your Square Dashboard to your Square Kiosk app. After 10 minutes, refresh the Kiosk app by tapping Start new order or by closing the app and reopening.
2. Ensure the item is assigned to a category and that category is enabled on your kiosk menu. Edit Category > Channel visibility > Kiosk: ON > Save.
3. Ensure the missing item has the proper settings enabled to appear on the kiosk menu. On the Edit Item page, check the following:
   a. Under the Where it’s sold section, toggle Kiosk ON.
   b. Under Site visibility section, select Visible.
   c. Scroll to Fulfillment and select Online fulfillment methods > Edit > Self-serve ordering > Done.

If you have duplicate copies of items appearing on your kiosk menu, follow these steps on your Square Dashboard:

1. Check for duplicate item entries: In your Item Library use the search bar to locate the duplicate item. If more than one entry appears, delete the copy of the item.
2. Check the item’s assigned categories: Select the duplicate item to open the Edit Item screen. Ensure there is only one category under Categorization. If an item is assigned to more than one category, it will appear multiple times on your Kiosk menu.

Printer settings for your Square Kiosk are located on your companion Point of Sale device. This device is the main POS device that is connected to your printers via USB, Bluetooth, Ethernet, or Wi-Fi.

If an order is placed on your Square Kiosk and an order ticket doesn’t print, follow these troubleshooting steps:

1. Check to make sure that Online & Kiosk Order Tickets is enabled for the printer.
2. On your Square Dashboard, go to Printer profiles > select the connected profile > Edit > Online & kiosk order tickets > toggle ON.
3. On your companion POS, open your Square app and navigate to More > Settings > Hardware > Printers > Profile > Edit > Online & kiosk order tickets > toggle ON.
4. If you are printing by category, ensure that the categories enabled for Square Kiosk are selected in the printer profile as well. Select Edit printer profile > Categories to Print > check all that apply and tap Save.
5. Place a test order on your Square Kiosk to test the printer settings.

If you have confirmed the settings above are correct but are still experiencing printer issues, perform the following:

1. Check and troubleshoot your companion POS device’s network connection.
2. Check and troubleshoot your printer’s connectivity.