Captive portal detection

Revision Information
  • Revision id: 267336
  • Created:
  • Creator: Dave Rose
  • Comment: Reworded content for ease of reading/flow and included link to AUP
  • Reviewed: Yes
  • Reviewed:
  • Reviewed by: lsiebert
  • Is approved? Yes
  • Is current revision? No
  • Ready for localization: Yes
  • Readied for localization:
  • Readied for localization by: lsiebert
Revision Source
Revision Content

Captive portal checks

Firefox's captive portal detector tests whether the network connection requires you to log in or accept the network's terms before permitting you to use the network. This is most often the case when using a public Wi-Fi hotspot, but it can also be a corporate guest network that prompt's you to agree to it's acceptable use policy. Firefox tests if the conection is a capacitive portal by regularly connecting to http://detectportal.firefox.com/canonical.html. Firefox will also make connections to this URL to check if your current network supports certain technologies such as IPv6.

What to do after the captive portal check

If the page was left open by Firefox, you may simply close it.

If this happens frequently please file a Networking bug and describe what happened (requires creating a Bugzilla account).

How captive portals work

Most captive portals redirect you to a login page or agree to an Acceptable Use Policy - AUP. Firefox will make automatic connections to detect these redirects and will notify you by indicating that you may need to log into the network. Normally, after you do this, the tab will be closed automatically. Occasionally, it will be kept around to display a message from the network's owners.