Storage quota estimate
Reports how much storage the origin may use, which tracks total disk size.
In one line
Can see how much storage the site may use, which tracks your disk size
Reports how much storage the origin may use, which tracks total disk size.
Chrome and Safari set the quota near 60% of total disk, so quota reveals disk size within a few GB, and Incognito shows a much smaller number. Also usage shows how much the site has already stored.
What it can and can't do
What the user does: Nothing. It happens when the page loads
It can
- See the storage quota, about 60% of total disk in Chrome and Safari
- See how much the site has already stored
- Guess your disk size class from the quota
- Spot a private window from its smaller quota
It cannot
- See exact free disk space
- See other sites' stored data
- Look at your files
- Be exact; numbers have noise and rounding
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 61 | 2017-09-05 | None |
| Edge | Supported | 79 | 2020-01-15 | None |
| Firefox | Supported | 57 | 2017-11-14 | None |
| Safari | Supported | 17 | 2023-09-18 | None |
| Safari on iPhone | Supported | 17 | 2023-09-18 | None |
| Chrome on Android | Supported | 61 | 2017-09-05 | None |
| Samsung Internet | Supported | 8.0 | 2018-07-18 | None |
How a site asks for it
| API | navigator.storage.estimate() |
| Browser compat keys | api.StorageManager.estimate |
| How access is granted | none |
| What the user sees | None |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | No |
| How long it lasts | read fresh on every page load; nothing stored |
| How to take it back | none needed (no grant) |
| Inside an iframe | Readable from cross-origin iframes too (same values) |
Typical flow
- Page script reads the value
- No prompt is shown
Data you get
Shape: object
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
quota | integer | bytes | about 100 MB to several TB | Chrome adds small noise and bucketing in some versions |
usage | integer | bytes | 0 up to quota | padded for opaque responses |
Technical limits
- Cannot read free disk space
- Quota is per origin policy, not raw disk size
The story
What it is
Tells a site how much storage it may use, which is tied to your disk size.
For you
You never see it. A site that stores big offline files, like a game or movie, can ask how much room it has so it does not fail. The answer also says something about your disk size.
For makers
Apps that work offline need to know whether a download will fit. The quota is around 60 percent of the disk in some browsers, so it leaks disk size. Private windows show a smaller number, which is why some sites also use it to spot private mode.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A browser game with large offline assets checks storage space before downloading the next level pack. | None named |
| video | A streaming site checks room before letting you save a movie for offline viewing. | Netflix |
| productivity | An offline first notes or email web app checks space before saving mailbox data. | None named |
| creative | A browser video editor checks space before caching large clips. | Clipchamp |
| security | A fraud tool compares the quota size with the claimed device to spot mismatches. | None named |
| news | A news site detects tiny quotas that suggest private mode and applies its free article limit. | None named |
| ads | A fingerprint vendor uses the quota as a stable disk size hint. | None named |
Risks
- Reveals disk size
- Used to spot private windows
What the platform says
- Google: Storage for the web. web.dev explains how sites can ask how much space they may use and plan around it.
Good uses and abuse
Legitimate uses
- Check room before caching video
Known abuse
- Disk-size and incognito inference
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 3 | Rough identifying entropy, when known |
History
- 2020-01, Chrome: Incognito quota reduced and disguised to hamper detection
- 2023-09, Safari 17: Origin quota up to 60% of total disk for browser apps
Related capabilities
Related
- Private browsing detection. Can often tell if you are in a private window, until browsers close the gaps
- Free disk space. Can't see exact free disk space, only a fuzzy storage quota
Sources
How well checked: Based on official documentation.