Origin Private File System
A private, fast file area per site that the person cannot browse and that counts against quota.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 86 | 2020-10-20 | None |
| Edge | Supported | 86 | 2020-10-09 | None |
| Firefox | Supported | 111 | 2023-03-14 | None |
| Safari | Supported | 15.2 | 2021-12-13 | None |
| Safari on iPhone | Supported | 15.2 | 2021-12-13 | None |
| Chrome on Android | Supported | 109 | 2023-01-10 | None |
| Samsung Internet | Supported | 21.0 | 2023-05-19 | None |
How a site asks for it
| API | navigator.storage.getDirectory() |
| Browser compat keys | api.StorageManager.getDirectory |
| 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 | Same lifetime and quota as other origin storage |
| How to take it back | Clear site data, browser privacy settings |
| Inside an iframe | Not listed |
Data you get
What comes back: Files in a private directory
Shape: binary
How often: any time
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
quota | integer | percent of disk | 10 to 60 | approximate |
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
| Type | Example | Apps |
|---|---|---|
| games | A browser game keeps its big world files and saves here for fast loading. | None named |
| creative | A web video editor keeps your clips here while you cut them. | None named |
| developer | A browser database like SQLite keeps its data file here. | SQLite Wasm |
| productivity | A note or document app keeps its offline library here. | None named |
| media | A web music or podcast app keeps downloaded episodes here. | None named |
| security | A 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
- web.dev: Origin Private File System. Google pitches it as fast, private file storage in the browser for databases and big files.
Good uses and abuse
Legitimate uses
- Large local databases (SQLite WASM), game assets
Known abuse
- Hidden data stash
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 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 | 0 | Rough 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
Related capabilities
Related
- IndexedDB. Can keep gigabytes of organized data for its own site in your browser
Sources
How well checked: Based on official documentation.