Skip to Content
Platform.Ontology

Storage quota estimate

Reports how much storage the origin may use, which tracks total disk size.

Gets silentlyDevice detailsStorageWeb browsersWhen the page loadsWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported612017-09-05None
EdgeSupported792020-01-15None
FirefoxSupported572017-11-14None
SafariSupported172023-09-18None
Safari on iPhoneSupported172023-09-18None
Chrome on AndroidSupported612017-09-05None
Samsung InternetSupported8.02018-07-18None

How a site asks for it

APInavigator.storage.estimate()
Browser compat keysapi.StorageManager.estimate
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
quotaintegerbytesabout 100 MB to several TBChrome adds small noise and bucketing in some versions
usageintegerbytes0 up to quotapadded 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

TypeExampleApps
gamesA browser game with large offline assets checks storage space before downloading the next level pack.None named
videoA streaming site checks room before letting you save a movie for offline viewing.Netflix
productivityAn offline first notes or email web app checks space before saving mailbox data.None named
creativeA browser video editor checks space before caching large clips.Clipchamp
securityA fraud tool compares the quota size with the claimed device to spot mismatches.None named
newsA news site detects tiny quotas that suggest private mode and applies its free article limit.None named
adsA 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

Good uses and abuse

Legitimate uses

  • Check room before caching video

Known abuse

  • Disk-size and incognito inference

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits3Rough 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

Sources

How well checked: Based on official documentation.

On this page