Captive portal troubleshooting
Start from what the guest sees, not from the settings. Every guide below is cause, check and fix, with the exact error kinds and codes the VoqadoWiFi integration records, so you can match what is on your screen to what is wrong.
Reviewed by Pierre Subeh, Founder, VoqadoWiFi · Written by the VoqadoWiFi team · Updated
Pick the symptom
The two minute triage
- Use a phone that has never joined the guest network, with mobile data off.
- Join. Does the login window open within a few seconds? If not, go to portal not showing on iPhone or Android no internet.
- Does it open but stay blank or unstyled? The walled garden is incomplete.
- Does the form submit and the phone stay offline? Open Portal Health and read the error kind.
- Does the login come back later? See guests reconnect every day.
Error kinds in Portal Health
Every authorization attempt is recorded with one of six error kinds when it fails. They are the same for Omada and UniFi.
| Error kind | Meaning | Guide |
|---|---|---|
| network | The controller address could not be reached | WiFi never unlocks |
| timeout | No answer within 8 seconds | WiFi never unlocks |
| ssl | Certificate failure on the way to the controller | Certificate warnings |
| auth | Login or token rejected, or nothing configured | UniFi 403, Omada codes |
| controller | The controller answered with an error | Omada codes |
| unknown | Anything else; read the message | WiFi never unlocks |
Questions
What is the first thing to check when a captive portal fails?
Why does it work on my phone and not on guests’ phones?
Do these guides apply to other hardware?
Keep reading
Checked against the integration code on 7 October 2026.
Get the free Guest WiFi Launch Pack
Four worksheets for switching guest WiFi on at your venue: a network inventory, a launch acceptance checklist, a change window plan and a staff handoff. Works for Omada and UniFi setups.
Get Portal Health on your own network The free dashboard records every guest authorization with its error kind. One location and 500 guest logins a month, no card. Create your free account