Troubleshooting
·
Updated Mar 27, 2026
Troubleshooting — Display Board Shows Wrong or Outdated Data
2 min read
676 views
Troubleshooting — Display Board Shows Wrong or Outdated Data
Symptoms
- Display board appears frozen
- Announcements not updating
- Display shows empty queue despite active tickets
- Display shows "Offline" in admin panel
Likely Causes
| Cause | Description |
|---|---|
| WebSocket dropped | Browser fell back to Livewire polling (slower, ~30s interval) |
| Redis cache corruption | Announcement cache returned corrupted data |
| Heartbeat missed | Display browser was closed or crashed |
| Stale display token | URL was regenerated but old URL still in use |
What Support Should Check
- Go to Admin → Displays — does the screen show Online or Offline?
- Confirm the display URL/token has not been recently regenerated.
- Ask the user: is the display browser tab open and fully loaded?
Resolution Steps
- Reload the display browser tab (press F5 or Ctrl+R).
- Check the browser console for WebSocket errors (F12 → Console).
- If announcements are stuck: the cache auto-busts on corruption. Wait 60 seconds or reload.
- If the display has been showing the old URL after token regeneration: update the URL.
- If issues persist:
php artisan cache:clearon the server to clear Redis.
What Engineering May Inspect
app/Livewire/Display/QueueBoard.php— announcement cache guard and corruption handlingapp/Http/Controllers/Display/SseStreamController.php— SSE fallback health- Redis key:
tenant:{tenantId}:display:{screenId}:announcements - Laravel Horizon:
broadcastingqueue depth and failed jobs
Was this article helpful?
Let us know so we can improve our documentation.
Thanks for your feedback!
Glad we could help.
Sorry to hear that
How can we improve this?
Thanks for your feedback!
We'll use your feedback to improve.
Related articles