Get Help With the Toast App on the POS

Last updated: May 1, 2026, 1:42 PM

Learn about troubleshooting steps for the unlikely event that you experience issues with the Toast app, such as the "Unfortunately, Toast POS has stopped" error.

In this Article:

 

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.

 

Back to top

 

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

  1. From the device home screen, select the main menu (the white circle with six dots).
  2. Select Settings, then select Apps.
  3. Locate and select Toast POS.
  4. 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.
  5. Reopen the Toast POS app from the home screen.

 

Expected outcome: The Toast POS app reopens to the passcode screen and is responsive.

 

Back to top | Back to If your screen is frozen or unresponsive

 

When the screen is fully frozen and won't accept input

  1. Press and hold the device power button for five to ten seconds until the device powers off.
  2. Press the power button to turn the device back on.
  3. 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.

 

Back to top | Back to If your screen is frozen or unresponsive

 

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.

 

Back to top | Back to If your screen is frozen or unresponsive

 

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.

 

error message on Toast device "unfortunately Toast POS has stopped"

 

  1. Select OK on the error prompt.
  2. 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.

 

Back to top

 

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.

 

  1. Press and hold the device power button for 10 to 15 seconds to fully power down.
  2. Unplug the device's power cord and wait one to two minutes.
  3. 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.

 

Back to top

 

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.

 

  1. From the home screen, swipe up from the bottom of the screen to open the App tray.
  2. Press and hold the Toast POS app icon until you see a small bubble that says App info.
  3. 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.

 

Back to top

 

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.

 

  1. From the device home screen, select Settings.
  2. Select Network & internet, then select Wi-Fi.
  3. Select the connected Wi-Fi network and select Forget.
  4. 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].

 

Back to top

 

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.

 

  1. From the Toast POS app passcode screen (Switch User), select the overflow menu (the three dots at the top right of the screen).
  2. From the menu, select Log Out.
  3. 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.

 

Back to top

 

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.

 

Back to top

 

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

 

Back to top

 

Related articles

 

Back to top