Connected Displays
What it does
The Connected Displays tab lists every kitchen, customer and order status display connected to this POS terminal right now. Use it to confirm a new display connected, or to find out why a display stopped updating.
Open the Connected Displays tab
- Tap Settings in the left drawer.
- Tap Connected Displays.
INFO
🔒 Manager only - the Settings item shows only for staff whose role has permission to see it. Roles are set up in the Admin portal.
| About this tab | Detail |
|---|---|
| How changes are saved | There is nothing to save. The tab only shows information |
| How the list updates | By itself, as displays connect and disconnect. There is no refresh button |
| Applies to | This terminal only. Each terminal lists the displays connected to it |
Check that a display is connected
- Tap Settings, then tap Connected Displays.
- Check the status at the top reads Listening on port and a number.
- Find the display under Connected Devices.
- Check the row shows Active.
- Tap the row to see its details.
Status at the top
| Status | What it means |
|---|---|
| Listening on port [number] | This terminal is ready. Displays can connect on that port |
| Display server not running | This terminal is not accepting displays |
| Server error on port [number] | This terminal could not open the port. No display can connect until it is fixed |
Filter tiles
The four tiles show a count. Tap a tile to show only that type in the list.
| Tile | What it counts and shows |
|---|---|
| Total Devices | Every connected display |
| Kitchen Displays | Kitchen displays only |
| Customer Displays | Customer displays only |
| Order Status | Order status displays only |
What each row shows
| Part of the row | What it shows |
|---|---|
| Name | The name the display gave when it connected |
| Type | Kitchen Display, Customer Display, Order Status Display or Unknown |
| IP address | The network address of the display |
| Connected | How long ago the display connected |
| Active | The display sent a signal within the last 60 seconds |
| Idle | The display has sent no signal for more than 60 seconds |
Device Details
Tap a row to open Device Details.
| Field | What it shows |
|---|---|
| IP address | The network address of the display |
| Last activity | When the display last sent a signal |
| Connected at | When the display connected |
| Device ID | The ID this terminal gave the connection |
| User agent | Technical details of the display's browser or app, when sent |
| Metadata | Extra details the display sent when it connected, when sent |
Connect a new display
- Tap Settings, then tap Device on the POS.
- Note an address under Network addresses and the Socket port.
- Open the display app on the display.
- Enter the address and port in the display app's connection field.
- Tap Settings, then tap Connected Displays on the POS.
- Check the display appears in the list.
The connection address has this format:
IP address:portExample: 192.168.1.10:59590
WARNING
Every display must be on the same network as the POS terminal. A display on a guest network cannot connect.
Rules and limits
| Rule | Detail |
|---|---|
| A display has 10 seconds to identify itself | A display that connects but does not say what it is within 10 seconds is disconnected |
| Kitchen displays need to be in your subscription | A kitchen display is refused when your subscription plan does not include the Kitchen Display Screen |
| Order status displays need to be in your subscription | An order status display is refused when your subscription plan does not include the Order Status Display |
| Active means a signal in the last 60 seconds | After 60 seconds without a signal the row changes to Idle |
| The list is not saved | Restarting the POS clears the list. Displays appear again as they reconnect |
Display types
| Type | What it is for | Guide |
|---|---|---|
| Kitchen Display | Shows orders to the kitchen | Kitchen Display |
| Customer Display | Shows the cart and promotional media to the customer | Customer Display |
| Order Status Display | Shows order progress to waiting customers | - |
Messages you may see
| Message | What it means / what to do |
|---|---|
| Display server could not start on port [number] | This terminal could not open its port. Follow the hint under the message. In most cases, change Local socket port in Settings → Device, then restart the POS. |
| No devices connected | No display is connected to this terminal. Open the display app and point it at this terminal. |
| Connect on port [number] | The port to enter on the display. |
| Nothing matches this filter | Displays are connected, but none of the type you tapped. Tap Total Devices. |
| Updates live as displays connect and disconnect. Tap a row for details. | The list is up to date. You do not need to refresh it. |
The hint under Display server could not start depends on the cause:
| Cause | What to do |
|---|---|
| The port is reserved by the device | Change Local socket port in Settings → Device to a different number, then restart the POS |
| Another application is already using the port | Close that application, or change Local socket port in Settings → Device, then restart the POS |
| Any other cause | Check Local socket port in Settings → Device, then restart the POS |
FAQs
My display does not appear in the list. What should I check?
Check these in order:
- The status at the top reads Listening on port.
- The display is on the same network as the POS terminal.
- The address and port on the display match Settings → Device on this terminal.
On Windows, see Display Connection Issues.
My kitchen display connects and then drops out straight away. Why?
Your subscription plan may not include the Kitchen Display Screen. The POS refuses a kitchen display or an order status display that the plan does not cover. The display shows a message asking you to upgrade the plan.
A display shows Idle. What does that mean?
The display has sent no signal for more than 60 seconds. Check the display is switched on and still on the network.
Where is the Refresh button?
There is none. The list updates by itself as displays connect and disconnect.
The customer display is connected but shows old settings. How do I fix it?
Tap Settings, then tap Customer Display. Change a setting, then tap Send to display. See Customer Display.
I changed the port and my displays will not reconnect. What now?
Restart the POS first. Then change the port in the connection address on each display.
Does this tab list displays connected to my other terminals?
No. Each terminal lists only the displays connected to it.
Next steps
- Device settings - find the address and port that displays connect to
- Customer Display - choose what the customer-facing screen shows
- Display Connection Issues - fix a display that will not connect
