File System Access (read and write handles)
Lets a site open files and folders and save changes back in place.
In one line
Can open files and folders you pick and save changes back in place
Lets a site open files and folders and save changes back in place.
Gives a site read and write access to specific files or directories the person picks. Since Chrome 122 a grant can persist across visits, so the site keeps access to your folder until revoked.
What it can and can't do
What the user does: You click Open or Save, pick, then click Allow.
It can
- Open the files or folders you pick
- Save changes back after you allow it
- Keep access on later visits if you choose Allow on every visit (Chrome 122 and newer)
- Skip the prompt when installed as an app
It cannot
- See files or folders you did not pick
- Reach system folders
- Work in Firefox or Safari
How it differs between platforms: Chrome and Edge on computers only. Firefox, Safari and phones do not have it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 86 | 2020-10-20 | None |
| Edge | Supported | 86 | 2020-10-09 | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Not supported | Not available | Not listed | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | showOpenFilePicker(), showSaveFilePicker(), showDirectoryPicker(); handle.requestPermission({mode:'readwrite'}); IndexedDB stored handles |
| Browser compat keys | api.FileSystemHandleapi.Window.showOpenFilePickerapi.FileSystemFileHandle |
| How access is granted | picker |
| What the user sees | Picker chooses what to share; a write prompt appears; Chrome 122 adds three-way prompt: Allow this time, Allow on every visit, Don't allow. Installed apps skip the prompt. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | One-time until tabs close, or persistent across visits in Chrome 122+ after Allow on every visit |
| How to take it back | Address bar icon Remove access, Site settings per-handle trashcan; auto-revoked after a background period |
| Inside an iframe | Not allowed in cross-origin iframes |
Typical flow
- User gesture
- showOpenFilePicker()
- Person picks file or folder
- Get FileSystemHandle
- queryPermission / requestPermission for readwrite
- Store handle in IndexedDB to reuse
Data you get
What comes back: FileSystemFileHandle or FileSystemDirectoryHandle
Shape: object
How often: per handle
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
mode | enum | none | read or readwrite | 2 values |
Technical limits
- Cannot enumerate disk silently
- System folders blocked (e.g. home, Downloads root)
- Chromium only for pickers; OPFS elsewhere
The story
What it is
Lets a site open files and folders and save changes back to them, once you allow it.
For you
You pick a file or folder in a system window. The site may ask again later to keep editing it. If you say no, it cannot touch the file.
For makers
It lets web apps replace installed software, so a person can use a browser tool instead of a download. Browsers remind the person and block sensitive folders.
Where you see it
| Type | Example | Apps |
|---|---|---|
| creative | A web code editor opens a project folder and saves changes straight to it. | VS Code for the Web |
| creative | A web photo editor edits a picture and saves it where it came from. | Photopea |
| games | A browser game creator opens a level file and saves it back as you build. | None named |
| productivity | A web note app keeps notes as normal files you can open elsewhere. | None named |
| enterprise | A company web tool opens a spreadsheet from a shared drive and saves changes in place. | None named |
| developer | A web build tool writes the finished site to a folder you pick. | None named |
| security | A phishing page asks for folder access to look like a document tool. Browsers refuse many system folders. | None named |
Risks
- Can change your files
- Chromium only
What the platform says
- web.dev: File System Access API. Google pitches it as letting web apps read and save files on your device, like native apps.
Good uses and abuse
Legitimate uses
- Editors and IDEs
- Photo and video tools
Known abuse
- Ransomware-style bulk edits if a folder is granted
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2020-10, Chrome 86: File System Access ships
- 2024-02, Chrome 122: Persistent permissions via handles in IndexedDB
- 2025-09, Safari 26: FileSystemWritableFileStream support (OPFS only)
Related capabilities
Related
- Persistent storage (persist). Can ask the browser not to delete its saved data when disk space is low
Sources
How well checked: Checked against real behavior.