Skip to Content
Platform.Ontology

Origin Private File System

A private, fast file area per site that the person cannot browse and that counts against quota.

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

In one line

Can keep fast private files in the browser that count against its storage limit

A private, fast file area per site that the person cannot browse and that counts against quota.

Hosts SQLite or media caches in the browser. Invisible to the person in the file manager, uses the origin quota, and lasts until site data is cleared. Needs no prompt, unlike the File System Access picker.

What it can and can't do

What the user does: Nothing. It happens when the app saves large files, databases or offline data.

It can

  • Store files in a private browser area
  • Open and change them quickly
  • Use them without a prompt

It cannot

  • Show them in your file manager
  • See your real files
  • Keep more than the site's storage limit
  • Share them with other sites

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported862020-10-20None
EdgeSupported862020-10-09None
FirefoxSupported1112023-03-14None
SafariSupported15.22021-12-13None
Safari on iPhoneSupported15.22021-12-13None
Chrome on AndroidSupported1092023-01-10None
Samsung InternetSupported21.02023-05-19None

How a site asks for it

APInavigator.storage.getDirectory()
Browser compat keysapi.StorageManager.getDirectory
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsSame lifetime and quota as other origin storage
How to take it backClear site data, browser privacy settings
Inside an iframeNot listed

Data you get

What comes back: Files in a private directory
Shape: binary
How often: any time

FieldTypeUnitRangePrecision
quotaintegerpercent of disk10 to 60approximate

Technical limits

  • Not visible to user
  • Same quota as IndexedDB
  • Sync access handles only in dedicated workers
  • No access to the real file system

The story

What it is

A private, fast file area per site that you cannot browse and that counts against your storage space.

For you

You never see it. It is why some web apps handle big files fast, and why a site can take up storage you cannot find in a folder.

For makers

It gives web apps quick, real file access with no prompt. Makers use it for in browser databases, big media and offline tools. It counts toward the quota the browser sets for each site.

Where you see it

TypeExampleApps
gamesA browser game keeps its big world files and saves here for fast loading.None named
creativeA web video editor keeps your clips here while you cut them.None named
developerA browser database like SQLite keeps its data file here.SQLite Wasm
productivityA note or document app keeps its offline library here.None named
mediaA web music or podcast app keeps downloaded episodes here.None named
securityA hidden ID file here is not shown in any normal browser storage list.None named

Risks

  • Storage you cannot see
  • Can persist an ID

What the platform says

Good uses and abuse

Legitimate uses

  • Large local databases (SQLite WASM), game assets

Known abuse

  • Hidden data stash

Scores

ScoreValueMeaning
Sensitivity2 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 bits0Rough identifying entropy, when known

History

  • 2020-10, Chrome 86: Shipped with File System Access
  • 2022-03, Safari 15.2: Shipped in Safari with worker sync access
  • 2023-03, Firefox 111: Shipped
  • IndexedDB. Can keep gigabytes of organized data for its own site in your browser

Sources

How well checked: Based on official documentation.

On this page