Free and total storage
Reads exact free and total disk bytes with no prompt; on iOS this needs a declared reason.
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
| Android | iPhone | |
|---|---|---|
| Status | Supported | Behind a flag |
| First version | Android 1.0 (API 1) | iOS 17.0 |
| Permission or entitlement | Not listed | entitlement |
| Protection level | none | entitlement |
| How access is granted | none | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | App Review: privacy manifest reasons must be declared; fingerprinting banned |
| Store policy | None listed | None listed |
| API | StatFs.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 |
| Notes | Exact byte counts; quota-aware allocatable bytes since Android 8 | None |
Data you get
What comes back: Bytes free, bytes total
Shape: integer
How often: On read
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
free_bytes | integer | bytes | 0 to total | 1 byte (exact) |
total_bytes | integer | bytes | 16 GB to 2 TB | about 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
| Type | Example | Apps |
|---|---|---|
| media | A streaming app checks free space before offering to download a whole series. | None named |
| games | A game warns you that an update needs 4 GB before it starts downloading. | None named |
| creative | A video app checks space before it starts recording in 4K. | None named |
| utilities | A cleaner app shows how full your phone is and what to delete. | None named |
| ads | An ad firm uses free bytes plus total size to tell phones apart. | None named |
| security | A 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
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | 6 | Rough 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
Related capabilities
Related
- 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
- Storage quotas and eviction. Can store only what your browser allows, and may lose it when space is low
- Storage quota estimate. Can see how much storage the site may use, which tracks your disk size
Sources
- Android: StatFs
- Apple: Describing use of required reason API
- Apple: URLResourceValues
- Apple: Privacy manifest files
How well checked: Inferred from related behavior.