Skip to main content

Troubleshooting

The problems kitchens actually hit, in the order they usually hit them.

No sound​

  1. Look at the alarm bar. Sound is off — tap to enable means the browser has not been touched since the last reload; tap it. Muted means someone muted it; tap it again. Both reset on every reload.
  2. Check the station in SSP Manager: Kitchen → Stations & capacity, Capacity tab, the station's Play sounds on the kitchen screen and Chime when a new order arrives switches. See Alarms and sounds.
  3. Check the tablet's own volume and that the browser tab is not muted at the system level.
  4. If the alarm bar keeps flipping back to Sound is off on its own, the tablet is suspending audio — usually a power-saving setting. Keep the screen awake during service.

The ticket is on the waiter's screen but not here​

  • Station. Open the picker. The dish's routing class must be subscribed by a station this screen shows. An unsubscribed class lands on the Default station; a dish with no class shows there with an Unrouted badge. Fix the class in Kitchen Routing.
  • Course. A dish in a held course is under the ticket in Coming later, not on it, until the course is fired.
  • Pre-order. An accepted pre-order waits in Later today until its start time.
  • Web order. An online order nobody has accepted is in Incoming web orders, not on the board.
  • Tab. A served or completed ticket is on Completed, not Active.

A dish shows on two stations​

Its row reads also at: …. Usually one of its options is cooked at another station — Add fries at the fry station — so the whole dish, with all its options, shows on both. Plating it on either screen plates it on both. Agree which station plates it. See A dish with an option cooked elsewhere.

The board is not updating​

The KDS gets changes live and also re-reads the board every 30 seconds. If the board is stale for longer:

  1. Reload the page. Stations and sort are remembered; you will need to tap Sound is off — tap to enable again.
  2. Check the tablet's network. During service the KDS shows no offline banner; a tap that fails shows a red message instead. If it can't reach SSP when it opens, it shows Couldn't reach the server and retries by itself; see Signing in and out.
  3. If it keeps happening on one screen only, the tablet is the problem; if on all screens, ask your administrator or SSP support to check live updates for the location.

A tap was refused​

A red message after a tap is the server's reason, word for word. The common ones:

MessageMeaning
Missing permission: update_item_list_status (serve_order_items allows SERVED, …)This login can serve but not cook — usually a floor manager's own login. The part in brackets lists what it may do instead. Sign the screen in with a Kitchen staff account.
Missing permission: … / This action is unauthorized.The account signed in on this screen lacks the ability. See Who can do what.
… still has a balance owed. Take the payment before completing it.Complete Order on an order that isn't paid yet. Complete it once the table has paid.
PAID is set by recording a payment, a refund or a void, not by a status change.The status dropdown can't set Paid, Partially paid, Voided or a refund. Those come from the payment itself.
… it is a finished sales record. Refund or void it instead.The order is already finished (paid in full, completed, cancelled, voided or refunded), so its status can't be changed from the KDS.
Cannot move a served item backUse Recall rather than a quick action for a served dish.
This order has already been accepted.Someone else decided this web order first. Nothing to do.
Not paid in full: the guest still owes …A website order still has a balance. The diner pays it from their order page; tap Picked up again once they have. See Pickup orders.
That order is not waiting to be collected.The website order was never accepted, or is already finished.
Start refused on a pre-orderIt isn't due yet. It appears on the board at its start time.

The row or dropdown springs back to what it was. A refusal never signs the screen out.

Nothing happens when I tap Start or Plate​

The ticket is probably waiting for an allergy acknowledgement. That refusal shows no red message: the allergy banner at the top of the ticket pulses instead, and if the banner is scrolled out of view you see nothing at all. Scroll up to the banner, read it and tap Acknowledge allergy.

If the account is a floor manager's login, the tap is refused with a red Missing permission message instead; see above.

The screen went back to "Sign in with SSP"​

The session expired or was revoked (a password change, a deactivated account, or a long idle time). Tap Sign in with SSP and sign in again; nothing already sent is lost. If it happens repeatedly during service, check that nobody is signing out of SSP Manager in the same browser (that signs the KDS out too), and give each screen its own account. See Signing in and out.

A dish is red the moment it is sent​

The dish has no prep time, or the station's thresholds are 0. With no prep time the row reads elapsed and never alarms; with a prep time and a 0-minute grace it turns red exactly when due. Set the prep time on the item and the grace period on the station in Kitchen Capacity.

The ticket controls are missing​

Mark Ticket Ready, Complete Order, Picked up and the status dropdown live on the screen that owns the ticket: the Expo screen if the location has one, otherwise every screen — and always All Stations. Fire course and Release course appear on the Expo screen only, and an Expo station ticked together with prep stations makes the screen an Expo screen. If a prep screen used to have the ticket controls and lost them, a station was given the Expo role in Manager. See Screens and views.

The Completed tab is missing older tickets​

Completed and All Orders show today's service only, from the location's opening time, and at most the 200 newest tickets. Use the Orders page in SSP Manager for anything older.

I 86'd a dish by mistake​

Put it back in SSP Manager (the item's availability); the KDS has no un-86. Tickets already carrying the dish were never affected.

Something is on the board that should not be​

  • A cancelled or voided ticket on Active: it should not be — cancelled and voided orders are not on that tab. If you see one, reload; if it persists, report the order code to your administrator.
  • A finished ticket that will not leave: once nothing is owed on it, set its status to Completed from the status dropdown (or Complete Order), or let the waiter close it. A website pickup order leaves when someone taps Picked up, on the board or from the chit's QR.
  • A quantity that is wrong: the waiter edited the ticket; the amber 2 → 3 chip shows what changed.

Where to get help​

For anything not covered here, contact SSP support with the location name, the order code from the ticket (the 8-character code beside the number), and the red message text if there was one.