Screens and kitchen troubleshooting
First work out whether the problem is with a desktop window, a browser page or the kitchen data itself. Each uses different settings. The Back Office pages below need an administrator. A kitchen screen signs in as a kitchen screen account, which belongs to one station, and a host stand signs in as a host stand account. Both are made in Back Office → Users → Cashiers.
A desktop window is missing or on the wrong monitor
Section titled “A desktop window is missing or on the wrong monitor”- Check that the monitor is switched on and that Windows detects it.
- In the FMX EPOS desktop app, open Back Office → Local Settings → Screens.
- Find the monitor by its name and device name. A monitor that was saved but is now unplugged shows Not connected.
- Set Shows to Till, Customer Display, Kitchen Screen, Host Stand or None.
- For a kitchen screen or host stand, choose Sign In As: a screen account opens the window without a PIN, and PIN Sign-In asks for a screen PIN of that kind. A kitchen screen account is listed with its station.
- Select Save Screens. The desktop app applies the change at once: it reopens a customer display or kitchen window that was closed and moves every window to its monitor. The page says “Screens saved and applied.”
Illustration, not a screenshot. The real screen can differ with the theme or version.
Exactly one monitor must show the Till, and at most one the Customer Display. Otherwise saving says “Choose exactly one display as the Till.” or “Choose at most one display as the Customer Display.” If an unplugged monitor still holds the Till, set it to None first. With only one monitor, no customer display opens, because it never shares the till’s monitor.
Detecting monitors and placing windows on them needs the desktop app. In a browser the page says “Screens are set in the FMX EPOS desktop app on this computer.” A customer display or kitchen window closed by hand reopens by itself. A kitchen window closed with Exit on its sign-in page, or a window that could not open (“The customer display could not be opened. FMX EPOS continues on the main screen.”), comes back when you select Save Screens.
Customer display and kitchen windows stay above the Windows taskbar on their monitor, so a notification or a flashing program does not bring the taskbar up over them. When a monitor is plugged in, unplugged or changes resolution, the desktop app places the windows again about two seconds later, as Save Screens does. If a kitchen screen’s monitor has gone, that window closes rather than covering the till, and opens again when the monitor is back. A customer display moves to another monitor that is not showing the till or a kitchen screen, or closes if there is none.
A window goes blank or shows Restarting EPOS
Section titled “A window goes blank or shows Restarting EPOS”The desktop app watches the browser engine (WebView2) inside each window. If a page stops working, the app reloads it by itself. A page that keeps failing is reloaded at most once every 30 seconds, and a page that stops answering is reloaded only after 30 seconds without an answer. If the whole engine stops, or the local FMX EPOS service stops, every window shows Restarting EPOS…. The till window then opens again at the page it was on, and the customer display and kitchen windows reopen.
To reload the till window yourself, press Ctrl+R in it. Check any payment or print that was in progress before you repeat it.
Each browser engine problem is written to the Windows Application event log as a warning whose text starts with “FMX EPOS”. In Event Viewer, these entries appear under the source .NET Runtime with Event ID 1000. If a window keeps reloading, send those entries with your support request.
A browser display says Access Restricted
Section titled “A browser display says Access Restricted”- The customer display (
/display) needs Till Web — PC, Mobile & Customer Display in Local Settings → Security. - The kitchen screen (
/kitchen) needs Kitchen Screen Web. - The host stand (
/host) needs Host Stand Web — PCs & Tablets. - The PIN page itself opens when any of Till Web, Kitchen Screen Web or Host Stand Web is ticked. With all three off it says “Till Web, Kitchen Screen Web and Host Stand Web access are disabled on this till. Open the desktop app and enable one in Local Settings → Security.”
- If Only Allow Listed IP Addresses is ticked, the device’s exact IP address must be on the list.
If the browser shows a certificate warning instead, the device has to trust the till’s HTTPS certificate. Follow Security and network access for these checks.
The customer display is blank or shows the wrong slideshow
Section titled “The customer display is blank or shows the wrong slideshow”- Check that the assigned window or browser is opening
/display. A display with no media shows the shop’s brand and “Welcome”. - On the terminal that runs the display, open Back Office → System Settings → Customer Display. For a browser display on a tablet, use the till whose address the tablet opens.
- Check that the media files are listed and in the order you expect. A file shown as “(missing)” is no longer on the PC and is skipped.
- Remove any file that is unsupported, damaged or missing (Remove Media? → Remove Media), and upload a JPG, PNG, WebP or MP4 file of up to 50 MB. Videos play without sound. Uploading, moving and removing files take effect straight away.
- Check Image Duration (3 to 120 seconds) and Display Text Size, then select Save Display.
Media files stay on the terminal they were uploaded to. A shared image duration does not copy the slideshow files from another PC. Image Duration applies to images only: a video always plays to its end before the next file.
If a browser display shows “The customer display connection was lost.”, select Reconnect.
During a database outage or a maintenance pause the display keeps its current look and slideshow, or the welcome screen if it has just opened. The order panel and payment notices keep updating. When the database is back it picks up the settings by itself, so nobody needs to touch it.
Signing in to a kitchen screen or host stand
Section titled “Signing in to a kitchen screen or host stand”- A desktop window set to a screen account in Local Settings → Screens opens by itself, with no PIN and no Sign Out. Signing out of or locking the till does not affect it.
- A desktop window set to PIN Sign-In has its own PIN page, titled Kitchen Screen or Host Stand. Enter the screen account’s PIN there. A staff PIN is refused with “This is a kitchen screen. Enter a kitchen screen PIN.” or “This is a host stand. Enter a host stand PIN.” A kitchen-only or host-stand-only terminal takes only its own kind of screen PIN in the same way.
- On a separate PC using a browser, open the till’s address and enter the kitchen screen PIN on the PIN page. It opens that account’s station. Kitchen Screen Web must be ticked in Local Settings → Security on the till; otherwise the PIN is refused with “Kitchen screen web access is disabled on this till. Enable it in Local Settings → Security.”
- For a host stand in a browser, on a PC or a tablet, open
https://<till address>:5139/hostand enter the host stand PIN. It needs Host Stand Web — PCs & Tablets; otherwise the page says Host stand web access is disabled on this till. Staff then unlock the host stand with their own PIN. - Phones and tablets cannot show a kitchen screen. Opening the till’s address on one goes to the Mobile Orders sign-in, which takes only staff PINs. Use a PC for each kitchen screen. On a tablet, only the host stand’s own address stays on the PIN page.
- “This screen account’s kitchen station is inactive or hidden. Check Users → Cashiers and Printing → Kitchen Stations.” means the account’s station is inactive or does not have Show on Screen ticked.
- Kitchen Display Not Licensed means the licence of the till the screen belongs to does not include the kitchen screen. Kitchen tickets still print. See Licences and licence modes.
- Not Updating in the kitchen screen’s header means the screen could not read new orders; the reason shows in a red bar under the filters. Select Refresh.
- If the screen shows “Rejoining the server…” or “Cannot reconnect to the server. Check the connection, then retry.”, it has lost its connection to the till. Check the network, then select Retry. If the bar “Connection interrupted.” appears, select Open Kitchen Screen (Open Host Stand on the host stand).
Illustration, not a screenshot. The real screen can differ with the theme or version.
Messages on a window that signs in by itself
Section titled “Messages on a window that signs in by itself”A window set to a screen account shows Opening this screen… while it signs in. If it cannot, it shows the reason and tries again every 30 seconds:
| Message | What to do |
|---|---|
| This terminal is paused for database maintenance. This screen will try again. | Wait for the maintenance to finish. The screen opens by itself afterwards. |
| Cannot open this screen. Check the connection. This screen will try again. | Check that FMX EPOS is running on this PC and can reach the restaurant database. |
| Cannot open this screen while the database is unavailable or emergency bills are waiting to synchronise. This screen will try again. | See During a database outage below. |
| This screen account was deleted. Choose another in Local Settings → Screens. | Choose another account, or PIN Sign-In, under Sign In As. |
| This screen account is inactive. Choose another in Local Settings → Screens. | Make the account active in Users → Cashiers, or choose another. |
| This kitchen station is inactive or hidden. Check it in Printing → Kitchen Stations. | Make the station active and tick Show on Screen. |
| This display is no longer a kitchen screen or host stand. Check Local Settings → Screens. | Set Shows for the monitor again and select Save Screens. |
Local Settings → Screens also checks a new choice when you save, for example “This screen account is inactive. Choose another account or PIN Sign-In.” A monitor that keeps an account which later stopped working is flagged on its own and does not stop the other monitors saving.
During a database outage
Section titled “During a database outage”A kitchen screen needs the restaurant database. While the database is unreachable it cannot show new orders, and it picks up again by itself when the database is back. A host stand keeps a read-only list of bookings and waiting guests during the outage. On the Emergency Terminal, which signs staff in from its own copy during an outage, a kitchen screen PIN reads “The PIN was not recognised. Try again.” After the database returns, kitchen screens cannot sign in until the Emergency Terminal has uploaded its emergency bills; until then a PIN gets “Cannot connect to the database. Check the connection and sign in again.” See Emergency terminal state.
No kitchen station is available for a screen
Section titled “No kitchen station is available for a screen”Open Back Office → Printing → Kitchen Stations. The station must be active and have Show on Screen ticked. Save it, then check in Users → Cashiers that the kitchen screen account uses that station. A screen whose station is not shown says “This station is not shown on screen. Ask a manager to check the account and station settings.” Deleting a station makes its screen accounts inactive; give each one another station and make it active again.
A kitchen order does not appear
Section titled “A kitchen order does not appear”The kitchen screen opens on To Prepare. Select All to see every open card, including held ones.
- Check that the order was released to the kitchen:
- A takeaway, collection or delivery order goes to the kitchen when it is paid or saved with Save Unpaid; a held order does not.
- A scheduled takeaway, collection or delivery order and an online order follow Printing → Print Rules → Kitchen Release. The Integration Host releases them, so it must be running. Until then the order is listed under Upcoming on the kitchen screen, marked Release overdue once its time has passed. An order set to Manual waits for staff to send it from Orders → Kitchen Release on the till. An online order appears only after it has been accepted.
- Table items go when you select Send. A card whose items are all in held courses appears under On Hold and moves to To Prepare when a course is fired. On a card that also has work to make now, the held items show in its HOLD section.
- Orders and table bills taken on the Emergency Terminal during a database outage never appear on the kitchen screen. They print kitchen tickets only. See Emergency terminal state.
- Check the product’s Kitchen Stations under Menus → Products.
- If no station is ticked, check that there is one active Default station.
- Check that Show on Screen is ticked for that station.
- Select Refresh on the kitchen screen.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Upcoming is read-only: its cards cannot be ticked or finished, and each shows Not Released until the order is released. Select Refresh to see a new upcoming order straight away. Once an order is released, its card moves to the other views.
The Kitchen Ticket column in Printing → Print Rules controls paper tickets only. It does not stop orders appearing on the kitchen screen.
Cards are in an unexpected order or lines are combined
Section titled “Cards are in an unexpected order or lines are combined”A card keeps the place it was given when its first work was called, that is, sent to be made now. Ticking items does not move a card. Cards that only have held work come last. To Prepare keeps showing a card until someone selects Done, even when every item is ticked.
A cancelled card stays in To Prepare until someone selects Acknowledge. It then stays open under All until someone selects Confirm Cancel.
Identical items on a card are shown as one line with the total quantity when Collapse Quantities is ticked in the station’s Kitchen Display section. The Collapse Quantities box under paper tickets affects only printed tickets. Weighed items, and products with Always Show This Product Separately ticked, always stay on their own lines. Items with different options, notes, courses or seats are never combined.
A ticket is held, overdue or cannot be ticked
Section titled “A ticket is held, overdue or cannot be ticked”Items in a held course cannot be ticked off until they are fired. A card with only held work normally shows Awaiting Fire instead of Done. If an update on it offers Confirm Update, you can finish that update; if Acknowledge is required, acknowledge it first, and the held work still waits for Fire. A card with both called and held work can be finished with Done; it comes back when the held course is fired, with the finished items shown as Done. The overdue timer starts when the work is ready to start, not when the held item was first entered, and it stops once every called line is ticked. Check the station’s Overdue After (seconds) and the course’s state before you change alert settings.
Done needs two taps: the button changes to Confirm? first, and changes back after a few seconds if you do not tap again. A card with a change still waiting for Acknowledge cannot be finished. Undo appears for five seconds after a ticket is finished. Done Orders lists recently finished tickets: open one and select Reopen. Reopening restores the ticket and its ticks; it does not create another order or paper ticket.
HOLD
Illustration, not a screenshot. The real screen can differ with the theme or version.
Alerts do not sound or do not stop
Section titled “Alerts do not sound or do not stop”- If the kitchen screen’s header shows Enable Sound, the browser has blocked sound. Tap Enable Sound once.
- Open Printing → Kitchen Stations, edit the station and check each alert in the Kitchen Display section. Any alert with a sound chosen always has to be acknowledged.
- Test next to a sound plays it on the device showing the Back Office page, not on the kitchen screen. To check the kitchen PC’s speakers and volume, use it on the kitchen PC itself.
Kitchen
Illustration, not a screenshot. The real screen can differ with the theme or version.
Tapping Acknowledge on a ticket stops its alert until the ticket changes again. The Updates filter pulses while any card there still waits for Acknowledge.
Illustration, not a screenshot. The real screen can differ with the theme or version.
For paper or label problems, see Printers and cash drawer.