Overview steps
Most Toast POS app issues — frozen screens, crashes, and missing icons — can be resolved by force stopping the app or power cycling the device. Use this article when the Toast POS app on a device isn't behaving as expected.
Important: Before resyncing data, factory resetting, uninstalling the app, or clearing data, check the device for unsettled credit card payments. Unsynced payments can be permanently lost. See Check Unsettled Credit Card Payments on Device.
|
Quick fix for most issues:
If the screen still responds to touch, force stop the Toast POS app from Settings.
If the screen is fully frozen, press and hold the device power button for five to ten seconds, then power back on.
If the issue persists after a power cycle, log out of the Toast POS app and back in.
If the issue continues, find the matching scenario below.
If your screen is frozen or unresponsive
A frozen screen is the most common Toast POS app issue. Recovery depends on whether the screen still responds to touch.
When the screen still responds to touch
From the device home screen, select the main menu (the white circle with six dots).
Select Settings, then select Apps.
Locate and select Toast POS.
On the App info page, scroll down and select Force Stop, then confirm. You can also clear cache or data on this page if needed.
Reopen the Toast POS app from the home screen.
Expected outcome: The Toast POS app reopens to the passcode screen and is responsive.
When the screen is fully frozen and won't accept input
Press and hold the device power button for five to ten seconds until the device powers off.
Press the power button to turn the device back on.
Reopen the Toast POS app.
Expected outcome: The device powers up and the Toast POS app loads. For full restart steps by device type, see Restart Your Device to Improve Performance.
When only part of the screen is unresponsive
If only part of the screen freezes — for example, half the screen is upside down, or one area won't accept touch — this usually indicates a hardware fault rather than an app issue. Skip the steps above and contact Customer Care.
If you see the "Unfortunately, Toast POS has stopped" error
This message appears when the Toast POS app encounters an issue and closes itself. Most cases resolve on the first try.
Select OK on the error prompt.
Reopen the Toast POS app from the home screen.
Expected outcome: The Toast POS app opens normally and you can resume use.
If the error appears repeatedly, force stop the app using the steps in If your screen is frozen or unresponsive.
If your terminal is stuck on the Toast logo at startup
If the device powers on, displays the Toast logo, and does not progress further, this usually indicates a deeper startup issue. Force stop and routine restart steps may not resolve a device that's stuck on the Toast logo.
Press and hold the device power button for 10 to 15 seconds to fully power down.
Unplug the device's power cord and wait one to two minutes.
Plug the power cord back in and power the device on.
Expected outcome: The device boots past the Toast logo and reaches the passcode screen.
If the device is still stuck on the Toast logo after a hard reset:
Contact Customer Care to complete a factory reset, or verify warranty status and discuss replacement.
If the Toast POS app icon disappeared from the home screen
If the Toast POS app icon is no longer visible on the device home screen, the app may have moved to the App tray. The app does not need to be reinstalled.
From the home screen, swipe up from the bottom of the screen to open the App tray.
Press and hold the Toast POS app icon until you see a small bubble that says App info.
While still holding your finger on the screen, drag the app to the home screen. Release when the icon is in the position you want.
Expected outcome: The Toast POS app icon is back on the home screen and ready to open.
If your Kitchen Display System (KDS) tickets keep freezing
If KDS tickets freeze, fail to bump, or disappear after a force stop, the device may be alternating between Wi-Fi and Ethernet connections.
From the device home screen, select Settings.
Select Network & internet, then select Wi-Fi.
Select the connected Wi-Fi network and select Forget.
Verify the device remains connected to the wired Ethernet network.
Expected outcome: The KDS device runs only on the Ethernet connection, removing the connection-switching cause.
For KDS-specific troubleshooting beyond freeze recovery, see [Related articles need to be added from KB].
If logging out doesn't resolve the issue
When force stopping and a power cycle haven't resolved the issue, log out and back in to refresh the app session.
From the Toast POS app passcode screen (Switch User), select the overflow menu (the three dots at the top right of the screen).
From the menu, select Log Out.
Sign back in with your email and password.
Expected outcome: The Toast POS app reloads with your session refreshed.
If logging out and back in didn't help, the next step is to resync the device's data.
Resyncing data can cause unsynced credit card payments to be permanently lost. Always check the Credit Card Queue first. Depending on your device, you may see Resync Orders, Resync Data, or Resync ALL Data in the overflow menu — these are different options. For full resync steps and which option to use, see Resync All Data on Your Devices.
|
If your Toast app won't update
If the Toast POS app hasn't updated and the new touchless installation hasn't taken effect, you can update manually.
For manual update steps, see Update Your Toast App.
Before you contact Customer Care
If the steps above didn't resolve the issue, gather the following before reaching out so Customer Care can assist faster:
Device info: The device's serial number and device type (for example, Toast Flex, Toast Flex 3, Toast Go® 2, Toast Go® 3, Elo terminal, or KDS)
Screenshot: A screenshot of any error message or symptom
Context: The action you were taking when the issue started (for example, processing a payment, opening Shift Review, or sending an order to KDS)
Pending payments: Whether the device has any pending credit card payments — see Check Unsettled Credit Card Payments on Device
Steps tried: The steps you've already tried from this article
Timing and scope: The time the issue started and whether it affects one device or multiple devices
Related articles