Skip to Content
Platform.Ontology

Join or suggest a Wi-Fi network

Adds a Wi-Fi network to the phone, usually to onboard a smart device.

Works without askingNetwork and connectionNetworkAndroid and iPhoneWhile you use it

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

AndroidiPhone
StatusSupportedBehind a flag
First versionAndroid 10 (API 29)iOS 11
Permission or entitlementCHANGE_WIFI_STATE (normal), NEARBY_WIFI_DEVICES for P2P (API 33)com.apple.developer.networking.HotspotConfiguration
Protection levelnormalentitlement
How access is grantedpromptentitlement
What the user seesNetwork suggestion approval notification or specifier dialogJoin Wi-Fi Network prompt
How long it lastsUntil removedUntil removed
How to take it backSettings > Network > Wi-FiSettings > Wi-Fi
Store policyNone listedNone listed
APIWifiNetworkSuggestion, WifiNetworkSpecifierNEHotspotConfigurationManager.apply
NotesSpecifier is temporary and local onlyCan join SSIDs with a joinOnce option

Data you get

What comes back: Configuration result
Shape: object
How often: once

FieldTypeUnitRangePrecision
ssidstringNoneup to 32 bytesNot 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

TypeExampleApps
smart-homeA smart plug app joins the plug's setup network, then sends your home Wi-Fi to it.TP-Link Kasa, Wyze
smart-homeA smart speaker app connects your phone to the new speaker during setup.Sonos, Google Home
travelA hotel app adds the hotel Wi-Fi so you connect on arrival.None named
automotiveA car app joins your car's Wi-Fi to download maps and updates.None named
wearablesA camera or drone app joins the device's own network to stream the video.DJI Fly, GoPro Quik
securityA 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

Good uses and abuse

Legitimate uses

  • Smart device onboarding

Known abuse

  • Forcing rogue network join

Scores

ScoreValueMeaning
Sensitivity3 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2017-09, iPhone iOS 11: NEHotspotConfiguration introduced
  • 2019-09, Android 10 (API 29): Network suggestions and specifier

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page