Skip to Content
Platform.Ontology

File System Access: folder picker and blocked folders

Lets the person grant a whole folder for reading and writing; sensitive system folders are refused.

You pick what to shareFiles and storageFilesWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported862020-10-20None
EdgeSupported862020-10-09None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported1322025-01-14None
Samsung InternetSupported29.02025-10-25None

How a site asks for it

APIshowDirectoryPicker({mode: 'readwrite', startIn}); FileSystemDirectoryHandle.values()
Browser compat keysapi.Window.showDirectoryPicker
api.FileSystemDirectoryHandle
How access is grantedpicker
What the user seesChrome folder picker, then View files and Save changes bubbles
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
Activationtransient
How long it lastsHandle storable in IndexedDB; permission per session or persistent in Chrome 122
How to take it backNothing to revoke (no permission is stored)
Inside an iframeNot in cross-origin iframes; secure context

Typical flow

  1. Person clicks
  2. Page calls showDirectoryPicker
  3. Chrome shows folder picker and View files confirmation
  4. 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

TypeExampleApps
creativeA web code editor opens your whole project folder and saves changes in place.VS Code for the Web
creativeA photo or music tool works on a folder of your files and saves edits back.Photopea
gamesA browser game level editor reads and writes your whole mod folder.None named
productivityA note taking web app keeps your notes as plain files in a folder you own.None named
developerA web tool builds a site into a folder on your computer.None named
securityA 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

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

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2020-10, Chrome 86: showDirectoryPicker ships with a path blocklist
  • 2024-02, Chrome 122: Persistent folder permissions

Sources

How well checked: Based on official documentation.

On this page