File System Access: folder picker and blocked folders
Lets the person grant a whole folder for reading and writing; sensitive system folders are refused.
In one line
Can open and change files in a whole folder you pick, but not system folders
Lets the person grant a whole folder for reading and writing; sensitive system folders are refused.
A folder grant shares every file inside it and lets the site edit them. Chrome refuses root, system and the profile home folders so one click cannot expose the whole disk.
What it can and can't do
What the user does: You click Open folder, choose a folder, then click Allow.
It can
- List every file and subfolder inside the folder
- Open files in it
- Save changes and create new files in it, after you allow saving
- Keep access on later visits if you choose Allow on every visit
It cannot
- See anything outside the folder you picked
- Pick sensitive folders, such as system folders or your whole home folder
- Save changes before you allow the Save changes prompt
- 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 | Supported | 132 | 2025-01-14 | None |
| Samsung Internet | Supported | 29.0 | 2025-10-25 | None |
How a site asks for it
| API | showDirectoryPicker({mode: 'readwrite', startIn}); FileSystemDirectoryHandle.values() |
| Browser compat keys | api.Window.showDirectoryPickerapi.FileSystemDirectoryHandle |
| How access is granted | picker |
| What the user sees | Chrome folder picker, then View files and Save changes bubbles |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| Activation | transient |
| How long it lasts | Handle storable in IndexedDB; permission per session or persistent in Chrome 122 |
| How to take it back | Nothing to revoke (no permission is stored) |
| Inside an iframe | Not in cross-origin iframes; secure context |
Typical flow
- Person clicks
- Page calls showDirectoryPicker
- Chrome shows folder picker and View files confirmation
- Page walks the tree through the handle
Data you get
Shape: none
No individual data fields. The signal is the access itself.
Technical limits
- Chrome 86 and later only; no Firefox, Safari
- Blocked for selection (Chrome blocklist): the drive root, system folders such as Windows, Program Files, System and Library on macOS, /etc and /usr on Linux, and the user's whole home folder; its subfolders can usually be chosen
- Two prompts: View files (read) and Save changes (write) when readwrite is requested
- Cannot move above the chosen folder; no path strings are exposed (only names)
- Large trees: values() iteration is async with no fixed cap; each entry needs permission checks
- Folders with executables get an extra warning for writes
The story
What it is
Lets you give a site read and write access to a whole folder. Sensitive system folders are refused.
For you
A system window asks you to pick a folder. A second prompt asks 'Let this site edit files in this folder?' Allow it and the site can change files until you stop it.
For makers
It lets web editors and tools work like desktop software on real folders. That wins users from native apps. Browsers block folders like Documents and Downloads roots to keep people safe.
Where you see it
| Type | Example | Apps |
|---|---|---|
| creative | A web code editor opens your whole project folder and saves changes in place. | VS Code for the Web |
| creative | A photo or music tool works on a folder of your files and saves edits back. | Photopea |
| games | A browser game level editor reads and writes your whole mod folder. | None named |
| productivity | A note taking web app keeps your notes as plain files in a folder you own. | None named |
| developer | A web tool builds a site into a folder on your computer. | None named |
| security | A scam site asks to edit a folder to plant or change files. Browsers refuse the system folders. | None named |
Risks
- Can change your files
- Powerful grant
What the platform says
- web.dev: File System Access API. Google pitches it as a way for web apps to read and save files and folders like native apps.
Good uses and abuse
Legitimate uses
- Code editors and static site tools
- Photo library organizers
- Backup and sync tools
Known abuse
- Mass file encryption or deletion
- Copying a whole folder tree to a server
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 5 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: showDirectoryPicker ships with a path blocklist
- 2024-02, Chrome 122: Persistent folder permissions
Related capabilities
Related
- File System Access: open and save pickers. Can open files you pick and save changes back to them, in Chrome and Edge
- Origin Private File System (OPFS). Can keep large private files in the browser that you cannot browse yourself
Sources
How well checked: Based on official documentation.