Skip to Content
Platform.Ontology

IndexedDB

A large browser database that can hold gigabytes of structured data for one site.

Works without askingFiles and storageIn sessionWeb browsersWhile you use itAfter you leave the site

In one line

Can keep gigabytes of organized data for its own site in your browser

A large browser database that can hold gigabytes of structured data for one site.

Stores app data, offline caches and, for trackers, bigger profiles or IDs that survive cookie clearing. Quota is a share of free disk, so a site can fill hundreds of MB without a prompt.

What it can and can't do

What the user does: Nothing. It happens as the site saves your work or caches data.

It can

  • Store lots of structured data, such as messages, notes or a catalog
  • Keep it between visits
  • Work offline with it

It cannot

  • Let other sites see it
  • Hold more than the site's storage limit
  • Keep it after you clear site data
  • Keep it after a private window closes

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported242013-01-10None
EdgeSupported122015-07-29None
FirefoxSupported162012-10-09None
SafariSupported82014-10-16None
Safari on iPhoneSupported82014-09-17None
Chrome on AndroidSupported252013-02-27None
Samsung InternetSupported1.52013-09-25None

How a site asks for it

APIindexedDB.open(name, version)
Browser compat keysapi.IDBFactory
api.IDBDatabase
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsBest effort: kept until the user clears it or the browser evicts under disk pressure. Safari applies the 7 day cap
How to take it backClear site data, browser privacy settings
Inside an iframeNot listed

Data you get

What comes back: Records in object stores
Shape: object
How often: any time

FieldTypeUnitRangePrecision
quotaintegerpercent of disk10 to 60approximate

Technical limits

  • Chrome: up to about 60% of total disk per origin
  • Firefox: about 10% of disk per site group, up to 10 GiB
  • Safari 17+: up to about 60% of disk per origin in the browser
  • Eviction is least recently used across origins
  • Partitioned in third party frames

The story

What it is

A large browser database that can hold gigabytes of organized data for one site.

For you

You never see it. It is why a web app has your emails or notes ready offline, and why a game keeps big progress without logging in.

For makers

It is the main database of the web. Makers use it for offline apps, game saves and caches. It can also hold an ID that survives clearing cookies in some cases.

Where you see it

TypeExampleApps
gamesA browser game made with Unity or Emscripten stores its save files and downloaded levels here.Unity WebGL games
productivityA web email or notes app keeps all your messages here for fast, offline search.Gmail
creativeA web design tool keeps your open file safe between visits.Figma
mediaA web music app keeps your downloaded songs here.None named
messagingA web chat app stores recent chat history for a quick start.Slack, WhatsApp Web
adsA tracking script keeps a hidden visitor ID here to bring you back after cookie clearing.None named
securityA web wallet or password tool keeps encrypted data here.None named

Risks

  • Hidden persistent ID
  • Large local data

What the platform says

Good uses and abuse

Legitimate uses

  • Offline apps, large local data

Known abuse

  • Cookie respawn store, large fingerprint caches

Scores

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

History

  • 2023-07, Chrome 115: Third party IndexedDB partitioned
  • 2023-09, Safari 17: Quota model changed: per origin share of disk plus 7 day cap kept
  • localStorage. Can keep up to about 5 MB of text notes per site, until cleared
  • Cache Storage. Can keep copies of pages and files so the site opens without internet
  • Origin Private File System. Can keep fast private files in the browser that count against its storage limit

Sources

How well checked: Checked against real behavior.

On this page