Last updated: May 21, 2026, 8:23 AM
Applies to: Toast Flex 14 terminal, Toast Flex for Guest (Wedge and Direct Attach), Toast Tap (Direct Attach), Toast Hub, Toast Printer (TP200).
Permissions needed:
What you'll accomplish: Diagnose and resolve common Toast Flex 14 hardware and connection issues, or confirm that a Return Merchandise Authorization (RMA) is required and reach Toast Customer Care with the right reference code.
Before troubleshooting any specific symptom, complete these three checks. They resolve a large share of Toast Flex 14 issues without further steps.
For an interactive troubleshooting walkthrough, use the Toast Flex 14 Troubleshooting Guide.
Use this table to match your symptom to the most likely fix. If self-service is "No," follow the linked section to confirm the symptom, then contact Toast Customer Care with the listed reference code.
| Symptom | Most Common Cause | Quick Fix | Self-Service? |
| Toast Flex 14 won't turn on | Power cable, USB-C cable, or stand issue | Inspect cables, try a known working power cable, test power directly into the stand. See My Toast Flex 14 Won't Turn On. | Yes (some)—replacement may be needed (code #504) |
| Has power but no Ethernet connection | Cable seating, IP settings, or Wi-Fi conflict | Reseat cables, confirm DHCP and Ethernet toggle are on, disable Wi-Fi. See I Have Power but No Ethernet Connection. | Yes—replacement may be needed (code #502) |
| Won't connect on Wi-Fi | Not connected to the secure Toast network | Connect to the _Secured Toast network and verify Wi-Fi signal. See My Toast Flex 14 Won't Connect to the Internet on Wi-Fi. | Yes |
| Screen has lines, flickering, dark band, dead pixels, or won't illuminate | Firmware out of date, or hardware failure | Update firmware to build 2.0.14 or higher; if no improvement, request RMA. See My Toast Flex 14 Screen Has Lines, Flickering, or a Dark Band. | No—replacement needed (code #503) |
| Touch isn't working on Toast Flex for Guest | Guest Display not enabled in Toast Web | Enable Guest Display screen. See I Can't Use Touch on My Toast Flex for Guest. | Yes |
| Toast Flex for Guest screen sleeps when terminal times out | Backlight timer set too short | Set backlight timer to Never. See My Toast Flex for Guest Goes to Sleep When the Terminal Times Out. | Yes |
| Toast Tap (Direct Attach) won't read chip cards | EMV disabled, or card insert orientation | Enable EMV, confirm card is inserted with stripe facing the tablet. See My Toast Tap (Direct Attach) Isn't Reading Chip Cards. | Yes |
| Toast Flex keeps losing connection to Hub or Printer | USB-C cable loose or damaged | Reseat the USB-C cable, tighten the thumbscrew. | Yes |
| "Unable to print. Your device may be on the wrong network." | Device on guest or personal Wi-Fi, not Toast network | Select Join Toast network. See I'm Getting an Error That Says "Unable to Print. Your Device May Be on the Wrong Network.". | Yes |
| Toast Flex 14 won't download an update | Cache or storage issue | Navigate to Settings, select Clear data, power off and reboot. See My Toast Flex 14 or KDS Won't Download an Update. | Yes |
If your Toast Flex 14 terminal won't power on, watch the video below or follow the steps to isolate the power supply issue.
Expected outcome: If the Toast Flex powers on and the Toast logo is visible, the terminal stand is broken, and could be used how it is currently plugged in, but if a replacement is wanted Contact Toast Customer Care and reference code #504. If the Toast Flex still won't power on, the terminal needs to be replaced. Contact Toast Customer Care and reference code #504.
This is troubleshooting that should be done if only one of your devices is offline. If you are experiencing an ISP outage, go to Outages and Disruptions: Troubleshoot Internet or Network Connection Issues.
Some Toast Flex 14 terminals use a USB-C to USB-C cable runs from the Toast Smart Hub or Toast Printer to the base of the Toast Flex 14 stand. This cable can carry both power and Ethernet to the tablet. Watch the video below or follow the steps to troubleshoot a failed Ethernet connection. For all Toast Flex 14 setups, including USB-C Ethernet, continue to the steps below.
Expected outcome: The Toast Flex 14 is online and the Toast app loads normally. If the connection still fails, contact Toast Customer Care and reference code #502.
This is troubleshooting that should be done if only one of your devices is offline, and is meant to be connected via Wi-Fi. If you are experiencing an ISP outage, go to Outages and Disruptions: Troubleshoot Internet or Network Connection Issues.
Toast Flex 14 terminals should be hardwired to the Toast network via Ethernet or USB-C to Printer or Toast Smart Hub wherever possible. If your terminal must be used with Wi-Fi, confirm it is on the correct network.
Expected outcome: The Wi-Fi indicator shows the Toast network as "Connected." For full Wi-Fi diagnostics, see Verify Your Internet Connection.
If your Toast Flex 14 or KDS device won't download a required update, verify that your device is online, and that there is nothing in the devices Credit Card, Model Sync, or Red Check Queues, then Clear Storage. This should only be done if all of these criteria are met, and the Email and Password to log into Toast are Known.
Expected outcome: The device retries the update on next sync. If the update still fails, contact Toast Customer Care.
If the touchscreen is not responding, the screen is flickering, or there are lines, a dark band, dead pixels, decolorized areas, or a non-illuminated backlight, watch the video below or follow the steps.
Note: If your restaurant uses self-managed devices, the firmware build will differ. Do not update the firmware on self-managed devices.
Expected outcome: If the firmware is current and the screen still shows dead pixels, lines, decolorized areas, or a non-illuminated backlight, contact Toast Customer Care and reference code #503 for a replacement.
To change the orientation of your Toast Flex display, follow these steps:
Expected outcome: The Toast Flex display rotates to your selected orientation immediately.
For Toast Flex for Guest touch to work, it must be enabled for your restaurant in Toast Web.
Expected outcome: Toast Flex for Guest works as intended after the change publishes.
On the back of your Toast Flex for Guest, there is a power button you can press to turn the screen back on. To stop the screen from sleeping when the terminal times out:
Expected outcome: The Toast Flex for Guest screen stays on while the terminal is idle.
If your Toast Tap (Direct Attach) is not reading chip cards, confirm EMV is enabled first.
If EMV is enabled and the Toast Tap (Direct Attach) still won't read chip cards, confirm guests are inserting their credit cards correctly. Chip cards (dip cards) should be inserted with the stripe facing the tablet and the chip facing away.
Expected outcome: Chip card transactions complete successfully. For deeper card reader troubleshooting—including resyncing, LED indicator checks, swapping USB ports, and running a test payment with the Card Reader Support app—see Get Help With Your Card Reader.
The Toast hardware system can use one power supply and one Ethernet cable to power the Toast Printer, Toast Flex, and Toast Tap.
Expected outcome: With one power supply and one USB-C to USB-C cable connected to the Toast Printer or Toast Hub, the Toast Flex powers on and receives Ethernet through the same cable.
To learn how to set up your Toast Printer for your Toast Flex 14, see Printer Setup Overview.
If the network is Toast Managed, and you are connected via Wifi, this error could mean the Toast terminal is not on the _Toast network.
Expected outcome: The Toast Flex automatically connects to the _Toast network and printing resumes.
Go to Find the Serial Number on Your Toast Device.
Most Toast Flex 14 hardware failures—broken screens, dead card readers, damaged cables, broken stands—require a Return Merchandise Authorization (RMA) and cannot be self-resolved. Before you start a live chat with Toast Customer Care, gather the following so the agent can issue the RMA in one pass:
Use reference code if applicable:
For the full RMA process, see Replace Faulty Hardware (RMA).
USB Type-C® and USB-C® are registered trademarks of USB Implementers Forum.