Last updated: May 11, 2026, 11:41 AM
Get help troubleshooting the Toast Flex 3 Terminal.
Learn how to troubleshoot your Toast Flex 3 Terminal.
In this Article:
Applies to: Toast Flex 3 Terminal, Toast Flex 3 Guest Display
Permissions needed:
What you'll accomplish: Diagnose and resolve common power, screen, internet, Guest Display, and card reader or accessory issues on the Toast Flex 3 Terminal.
Note: This article is for troubleshooting an installed Toast Flex 3 Terminal. If you are setting up a brand new Flex 3 for the first time, see the Toast Flex 3 Installation Guide instead.
If your Toast Flex 3 Terminal isn't behaving as expected, start with these high-level checks before working through the symptom-specific sections below:
If those checks don't resolve the issue, find your symptom in the Quick fix table below and follow the matching section.
Find your symptom in the table below, then jump to the matching section for full steps.
| Symptom | Most common cause | Quick fix | Self-service? |
|---|---|---|---|
| Terminal won't turn on or has no power | Loose power cable, faulty outlet, or Printing Hub power issue | Confirm the power supply LED is green; hold the orange button on the back for two seconds | Yes |
| Black screen, frozen screen, or general unresponsiveness | Device needs to reboot | Hold the orange button on the back for seven seconds until the LED blinks white | Yes |
| Touchscreen does not respond to touch input | Display works but touch input has stopped responding | Reboot the terminal; if the issue persists, see the touchscreen section below | Yes |
| No internet connection or "offline" banner | Ethernet cable issue or wrong network setting | Confirm the Ethernet cable is seated; confirm Wi-Fi is disabled and IP is set to DHCP | Yes |
| No power to the Guest Display | Brightness setting, USB cable, or device is off | Press the orange button on the Guest Display; check the brightness in quick settings; reseat the green USB cable | Yes |
| Card reader or accessory not responding | Loose cable, accessory needs reseating, or terminal needs reboot | Reseat the cable; reconnect the accessory; reboot the terminal | Yes |
| Setting up a brand new Flex 3 (not troubleshooting an installed device) | This article is for troubleshooting only | See the Toast Flex 3 Installation Guide | Yes—routes elsewhere |
If your Flex 3 Terminal does not power on when holding the orange button on the back, follow the steps for your power source.
Expected outcome: The Toast logo appears on the screen and the device boots to the Toast Launcher home screen.
Expected outcome: The Toast logo appears on the screen and the device boots to the Toast Launcher home screen.
If the terminal still does not power on after these steps, see Before you contact Customer Care.
The Flex 3 Terminal screen can fail in two distinct ways. The fix depends on whether the screen displays nothing, or whether it displays the Toast app but does not respond to touch.
If the terminal is on (LED indicator on) but the screen is black, frozen, or not displaying anything, start by rebooting the device.
Expected outcome: The Toast logo appears on the screen, followed by the Toast Launcher home screen or the Toast POS app.
If the screen displays the Toast app but does not respond when you touch it, the issue is touch input rather than the display itself.
Expected outcome: The screen responds to touch in all areas.
If rebooting does not solve the issue, try performing a factory reset.
Important: Before performing a factory reset, confirm there are no pending payments on the device. A factory reset erases all data on the terminal.
From Toast Launcher, press the circle button and navigate to Settings and Tools > Device Settings > System > Reset options > Erase all data (factory reset) > Erase All Data, then Erase All Data again.
Expected outcome: The terminal resets to factory state and walks you through initial setup. After setup, the screen should display and respond normally.
If the screen still does not work after a factory reset, see Before you contact Customer Care.
If you are experiencing issues with your internet connection, work through these steps in order.
Check the top-right icon in your terminal to confirm you have a connection. Three icon types indicate a connection: Wi-Fi, Ethernet, and USB.
Expected outcome: A Wi-Fi, Ethernet, or USB connection icon appears in the top-right corner of the terminal screen.
Expected outcome: The browser loads toasttab.com and the Ethernet icon shows a connection in the top-right corner of the terminal screen.
If you are experiencing issues with your Wi-Fi connection, see Get Help: Troubleshoot Network Equipment Error Messages.
If you are experiencing power supply issues with your Guest Display, try these troubleshooting steps:
Expected outcome: The Guest Display screen powers on and shows an image.
If the Guest Display still has no power after these steps, see Before you contact Customer Care.
If you're having trouble with a card reader or another accessory (such as a scanner connected to your Guest Display), start by checking the connection.
Expected outcome: The card reader or accessory responds normally — card swipes register, scanners read codes, or the accessory's status indicators show it is connected.
If the card reader or accessory is still not working, see Before you contact Customer Care.
If the steps above do not resolve your issue, gather the following information before contacting Customer Care to speed up your interaction:
To contact Customer Care, see How can I contact support in the Toast app?.