Troubleshooting

Display stuck on "Connecting" or not syncing

Symptom

The display device shows a spinning "Connecting" overlay, the standby dot never appears, or the display opens but doesn't respond when the director taps Live/Preview/Standby.

Most common causes

Wrong room code

Display link uses a different room code than the controller. Most common cause.

WebSocket blocked

Hotel, venue, or corporate WiFi blocks WebSocket connections on port 443.

Old cached URL

Display opened a bookmarked link from a previous session with a different room code.

No internet

Display device is on a network with no internet access — captive portal not accepted.

Fix 1 — Wrong room code (most common)

Most Common Check the room codes match

1

On the controller, note the 6-character room code shown in the Room Code card.

2

On the display device, check the URL — it should contain ?room=XXXXXX with the same code.

3

If they don't match, tap Copy Display Link on the controller and resend it, or show the QR code and have the display device scan it fresh.

Fix 2 — Venue WiFi blocking WebSockets

Network Issue Switch to cellular

1

On the display device, go to Settings → WiFi and turn WiFi off.

2

The device will switch to cellular (4G/5G/LTE). Reload the display page.

3

If it connects immediately, the venue WiFi is blocking WebSocket connections. Cue Light works fine on cellular — keep WiFi off for the shoot.

Venue WiFi tip: Hotel and convention centre guest WiFi commonly blocks WebSocket connections. If you're at a recurring venue that always has this problem, just use cellular on display devices from the start. It's faster and more reliable anyway.

Fix 3 — Captive portal (airport/hotel WiFi)

Accept the network login page first

1

Open Safari or Chrome and try to load any website (e.g., google.com).

2

If a login or terms page appears — accept it to gain internet access.

3

Return to the Cue Light display URL and reload.

Fix 4 — Hard reload the display page

Clear cached state

1

On iPhone/Android: tap the address bar, tap the reload button, or close and reopen the tab.

2

On desktop: press Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows) to hard reload.

3

If the display had an old bookmarked URL — delete it and use a fresh link from the controller's Copy Display Link button.

Still not connecting?

Start a fresh room

Close everything and open a new room. Share the fresh QR code to all display devices.

Open Cue Light

Related troubleshooting