Skip to Content
Platform.Ontology

Network type, metered and constrained flags

Reads whether the phone is on Wi-Fi, cellular or VPN, and if the connection is metered.

Gets silentlyNetwork and connectionConnectivityAndroid and iPhoneWhen the app opensWhile you use it

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

AndroidiPhone
StatusSupportedSupported
First versionAndroid 1.0 (API 1)iOS 12.0
Permission or entitlementACCESS_NETWORK_STATEnone
Protection levelnormalnone
How access is grantedinstallnone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedNone listed
APIConnectivityManager.getNetworkCapabilities(), NET_CAPABILITY_NOT_METEREDInterface types: wifi, cellular, wiredEthernet, other
NotesTransports: WIFI, CELLULAR, ETHERNET, VPN, BLUETOOTHNone

Data you get

What comes back: Transport and flags
Shape: enum
How often: On change

FieldTypeUnitRangePrecision
transportenumNoneWIFI, CELLULAR, ETHERNET, VPN4 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

TypeExampleApps
mediaA streaming app drops video quality on cellular to protect your data plan.Netflix, YouTube
musicA music app only downloads your playlists when you are on Wi-Fi.Spotify
gamesA game waits for Wi-Fi before it downloads a big update.None named
liveA live stream app lowers its picture when your signal gets weak.Twitch
productivityA cloud photo backup runs only on Wi-Fi or when plugged in.Google Photos
analyticsA 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

Good uses and abuse

Legitimate uses

  • Defer big downloads

Known abuse

  • Little

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits2Rough identifying entropy, when known

History

  • 2019-09, iPhone iOS 13: isConstrained (Low Data Mode) added

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page