Network type, metered and constrained flags
Reads whether the phone is on Wi-Fi, cellular or VPN, and if the connection is metered.
In one line
Can tell if you are on Wi-Fi, cellular or VPN, and if data is metered
Reads whether the phone is on Wi-Fi, cellular or VPN, and if the connection is metered.
Tells whether the person is at home or out, and whether data saving is on.
What it can and can't do
What the user does: Nothing. It happens when the app loads or before it downloads something big
It can
- Check if the phone uses Wi-Fi, cellular, Ethernet, VPN or Bluetooth
- Check if the connection is metered or limited
- Wait for Wi-Fi before big downloads
It cannot
- See the network's name without more permission
- See what you send or receive
- Switch networks for you
How it differs between platforms: Android needs a normal permission granted at install. iPhone needs none.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Supported |
| First version | Android 1.0 (API 1) | iOS 12.0 |
| Permission or entitlement | ACCESS_NETWORK_STATE | none |
| Protection level | normal | none |
| How access is granted | install | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | Not listed |
| Store policy | None listed | None listed |
| API | ConnectivityManager.getNetworkCapabilities(), NET_CAPABILITY_NOT_METERED | Interface types: wifi, cellular, wiredEthernet, other |
| Notes | Transports: WIFI, CELLULAR, ETHERNET, VPN, BLUETOOTH | None |
Data you get
What comes back: Transport and flags
Shape: enum
How often: On change
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
transport | enum | None | WIFI, CELLULAR, ETHERNET, VPN | 4 values |
Technical limits
- No SSID or IP info
The story
What it is
An app can see if you are on Wi-Fi, cellular or a VPN, and whether data saving is on.
For you
You do not see it. You notice that a podcast app waits for Wi-Fi to download, or a video drops to a lower quality on cellular. It also tells an app whether you are at home or out.
For makers
Makers use it to save your data, lower video quality, and defer big downloads. It is a low risk signal. Over time it shows when you are at home, at work or on the move.
Where you see it
| Type | Example | Apps |
|---|---|---|
| media | A streaming app drops video quality on cellular to protect your data plan. | Netflix, YouTube |
| music | A music app only downloads your playlists when you are on Wi-Fi. | Spotify |
| games | A game waits for Wi-Fi before it downloads a big update. | None named |
| live | A live stream app lowers its picture when your signal gets weak. | Twitch |
| productivity | A cloud photo backup runs only on Wi-Fi or when plugged in. | Google Photos |
| analytics | A tracker logs when you switch from home Wi-Fi to cellular to learn your day. | None named |
Risks
- Reveals home and away
- Little fingerprint value
Android and iPhone in short
- Android: Android reads network type, metered and VPN flags with the normal network state permission.
- iPhone: iPhone apps see whether a connection is expensive or constrained, which covers cellular and Low Data Mode.
What the platform says
- Google: Connectivity status. Android lets apps check what network you are on so they can save your data.
- Apple: Network path monitor. Apple lets apps watch the connection type and whether it is expensive or constrained.
Good uses and abuse
Legitimate uses
- Defer big downloads
Known abuse
- Little
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 2 | Rough identifying entropy, when known |
History
- 2019-09, iPhone iOS 13: isConstrained (Low Data Mode) added
Related capabilities
Related
- VPN active detection. Can see if a VPN is on, directly on Android and by guessing on iPhone
Same idea on the web
- Network Information API. Can see roughly how fast your connection is and whether you turned on data saving
Sources
How well checked: Based on official documentation.