Skip to Content
Platform.Ontology

Free and total storage

Reads exact free and total disk bytes with no prompt; on iOS this needs a declared reason.

Gets silentlyDevice detailsHardware capacityAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can see free and total storage on Android, and on iPhone only with a stated reason

Reads exact free and total disk bytes with no prompt; on iOS this needs a declared reason.

Exact free bytes change slowly and are near-unique, so they are a classic fingerprint. It also reveals device tier (64 GB vs 512 GB) and how full the phone is.

What it can and can't do

What the user does: Nothing. The app checks when it starts, or before a big download

It can

  • See exact free and total storage in bytes on Android
  • See how much space the app could free up on Android 8 and newer
  • Check space on iPhone for approved reasons, such as showing it to you or a low space warning
  • Warn you before a download that will not fit

It cannot

  • See the space on iPhone without declaring an approved reason; App Store checks began 1 May 2024
  • Use the number on iPhone for tracking or a device ID
  • See what is stored in other apps' folders

How it differs between platforms: Android allows it with no prompt. iPhone only allows it for listed reasons the developer must declare.

On Android and iPhone

AndroidiPhone
StatusSupportedBehind a flag
First versionAndroid 1.0 (API 1)iOS 17.0
Permission or entitlementNot listedentitlement
Protection levelnoneentitlement
How access is grantednonenone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedApp Review: privacy manifest reasons must be declared; fingerprinting banned
Store policyNone listedNone listed
APIStatFs.getAvailableBytes()/getTotalBytes() (API 18); StorageManager.getAllocatableBytes (API 26)Reason codes 85F4.1 (display), E174.1 (low-space behavior), 7D9E.1 (user-sent bug report), B728.1 (health research apps); enforced in App Store submissions since 2024-05-01
NotesExact byte counts; quota-aware allocatable bytes since Android 8None

Data you get

What comes back: Bytes free, bytes total
Shape: integer
How often: On read

FieldTypeUnitRangePrecision
free_bytesintegerbytes0 to total1 byte (exact)
total_bytesintegerbytes16 GB to 2 TBabout 0.93 of marketing size

Technical limits

  • Reason codes restrict off-device sending on iOS
  • Android has no equivalent gate

The story

What it is

An app can see how much free and total storage your phone has.

For you

You may see a warning that you need more space to download a movie. You will not see that the exact number of free bytes works like a near unique tag, because it changes slowly.

For makers

Makers need it to check space before big downloads and saves. The same exact number is a classic fingerprint, so Apple makes apps give a reason.

Where you see it

TypeExampleApps
mediaA streaming app checks free space before offering to download a whole series.None named
gamesA game warns you that an update needs 4 GB before it starts downloading.None named
creativeA video app checks space before it starts recording in 4K.None named
utilitiesA cleaner app shows how full your phone is and what to delete.None named
adsAn ad firm uses free bytes plus total size to tell phones apart.None named
securityA fraud tool notes that a device claims 64 GB but shows free space of a 512 GB model.None named

Risks

  • Exact number works as a tag
  • Shows how full your phone is

Android and iPhone in short

  • Android: Reads exact free and total bytes with no prompt.
  • iPhone: Needs a declared reason code in the privacy manifest.

What the platform says

  • Apple: Required Reason APIs. Developer rule: apps that read free disk space must declare an approved reason in their privacy manifest.

Good uses and abuse

Legitimate uses

  • Check space before download
  • Storage cleanup tools

Known abuse

  • Fingerprint
  • Device tier targeting

Scores

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

History

  • 2013-07, Android 4.3 (API 18): StatFs.getAvailableBytes added
  • 2024-05, iPhone iOS 17.x: Disk space is a Required Reason API; manifest reason required to ship
  • Required Reason: disk space. Can check your free storage on iPhone only with a stated reason, and freely on Android
  • RAM size. Can see how much memory your phone has, down to the exact byte, with no prompt

Same idea on the web

Sources

How well checked: Inferred from related behavior.

On this page