Join or suggest a Wi-Fi network
Adds a Wi-Fi network to the phone, usually to onboard a smart device.
In one line
Can add a Wi-Fi network to your phone, usually to set up a smart device
Adds a Wi-Fi network to the phone, usually to onboard a smart device.
Changes network state, so both OSes ask the person. Apple needs a capability and Android needs a normal permission.
What it can and can't do
What the user does: You tap Connect or Set up device and approve the Wi-Fi join prompt
It can
- Suggest or add a Wi-Fi network by name and password
- Join a device's setup Wi-Fi once, such as a speaker or camera
- Connect to a temporary local network on Android
- Join then leave the network on iPhone with the join once option
It cannot
- Add a network on iPhone without the Apple Hotspot entitlement
- See the networks you saved before
- Keep the temporary Android network after the app is done
- Join without your approval at the prompt
How it differs between platforms: iPhone needs a special Apple entitlement. Android suggestions are temporary and local to the app.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Behind a flag |
| First version | Android 10 (API 29) | iOS 11 |
| Permission or entitlement | CHANGE_WIFI_STATE (normal), NEARBY_WIFI_DEVICES for P2P (API 33) | com.apple.developer.networking.HotspotConfiguration |
| Protection level | normal | entitlement |
| How access is granted | prompt | entitlement |
| What the user sees | Network suggestion approval notification or specifier dialog | Join Wi-Fi Network prompt |
| How long it lasts | Until removed | Until removed |
| How to take it back | Settings > Network > Wi-Fi | Settings > Wi-Fi |
| Store policy | None listed | None listed |
| API | WifiNetworkSuggestion, WifiNetworkSpecifier | NEHotspotConfigurationManager.apply |
| Notes | Specifier is temporary and local only | Can join SSIDs with a joinOnce option |
Data you get
What comes back: Configuration result
Shape: object
How often: once
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
ssid | string | None | up to 32 bytes | Not listed |
Technical limits
- Prompt shown for every join
The story
What it is
An app adds a Wi-Fi network to your phone, often to set up a smart device.
For you
You see a prompt asking whether to join a network. You tap Join and the phone connects. It is how a new smart plug or speaker gets onto your Wi-Fi without typing a long password.
For makers
Makers use it to make setup of smart devices feel like magic. A bad app could try to push your phone onto a rogue network, so both platforms ask first and show the network name.
Where you see it
| Type | Example | Apps |
|---|---|---|
| smart-home | A smart plug app joins the plug's setup network, then sends your home Wi-Fi to it. | TP-Link Kasa, Wyze |
| smart-home | A smart speaker app connects your phone to the new speaker during setup. | Sonos, Google Home |
| travel | A hotel app adds the hotel Wi-Fi so you connect on arrival. | None named |
| automotive | A car app joins your car's Wi-Fi to download maps and updates. | None named |
| wearables | A camera or drone app joins the device's own network to stream the video. | DJI Fly, GoPro Quik |
| security | A bad app tries to add a rogue network, which is why a prompt shows the name. | None named |
Risks
- Forced join of a rogue network
- Phone drops its normal Wi-Fi
Android and iPhone in short
- Android: Android uses suggestions or a connect request that the person must approve.
- iPhone: iPhone needs the Hotspot Configuration capability and shows a join prompt.
What the platform says
- Apple: Hotspot Configuration. Apple lets apps add a Wi-Fi network after you approve, which makes smart device setup faster.
- Google: Wi-Fi suggestions. Android lets apps suggest Wi-Fi networks to join after you approve.
Good uses and abuse
Legitimate uses
- Smart device onboarding
Known abuse
- Forcing rogue network join
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2017-09, iPhone iOS 11: NEHotspotConfiguration introduced
- 2019-09, Android 10 (API 29): Network suggestions and specifier
Related capabilities
Related
- Connected Wi-Fi name and BSSID. Can see your Wi-Fi name, but only with location access and extra approval
Same idea on the web
- Wi-Fi name, BSSID and signal strength. Can't see your Wi-Fi name, router ID, or signal bars
Sources
How well checked: Based on official documentation.