Skip to Content
Platform.Ontology

File System Access (read and write handles)

Lets a site open files and folders and save changes back in place.

Asks you firstFiles and storageFilesWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported862020-10-20None
EdgeSupported862020-10-09None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APIshowOpenFilePicker(), showSaveFilePicker(), showDirectoryPicker(); handle.requestPermission({mode:'readwrite'}); IndexedDB stored handles
Browser compat keysapi.FileSystemHandle
api.Window.showOpenFilePicker
api.FileSystemFileHandle
How access is grantedpicker
What the user seesPicker 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 gestureYes
How long it lastsOne-time until tabs close, or persistent across visits in Chrome 122+ after Allow on every visit
How to take it backAddress bar icon Remove access, Site settings per-handle trashcan; auto-revoked after a background period
Inside an iframeNot allowed in cross-origin iframes

Typical flow

  1. User gesture
  2. showOpenFilePicker()
  3. Person picks file or folder
  4. Get FileSystemHandle
  5. queryPermission / requestPermission for readwrite
  6. Store handle in IndexedDB to reuse

Data you get

What comes back: FileSystemFileHandle or FileSystemDirectoryHandle
Shape: object
How often: per handle

FieldTypeUnitRangePrecision
modeenumnoneread or readwrite2 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

TypeExampleApps
creativeA web code editor opens a project folder and saves changes straight to it.VS Code for the Web
creativeA web photo editor edits a picture and saves it where it came from.Photopea
gamesA browser game creator opens a level file and saves it back as you build.None named
productivityA web note app keeps notes as normal files you can open elsewhere.None named
enterpriseA company web tool opens a spreadsheet from a shared drive and saves changes in place.None named
developerA web build tool writes the finished site to a folder you pick.None named
securityA 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

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

ScoreValueMeaning
Sensitivity4 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: File System Access ships
  • 2024-02, Chrome 122: Persistent permissions via handles in IndexedDB
  • 2025-09, Safari 26: FileSystemWritableFileStream support (OPFS only)

Sources

How well checked: Checked against real behavior.

On this page