Local-file APIs in Safari on a MacBook
Learn what Safari can do with files you choose, how to check API support on your MacBook, and what to try when a web app cannot open or save.
A website on your MacBook may ask you to choose a file, let you drag a file onto a page, or save an edited file back to your computer. If one of those actions does nothing in Safari, it may be an unsupported browser feature, a site-specific limitation, or a problem in the web app.
Use Browser Info to check which browser and engine Safari reports and review its supported features. Then test the actual file action in the website you need. A browser feature report can narrow down the cause, but it cannot guarantee that every site uses the feature correctly.
Check local-file support in Safari
- Open Browser Info in Safari on the MacBook you are troubleshooting. Review the browser version, engine, and supported features shown by the tool.
- Open the web app that is having trouble. If possible, start with a non-sensitive test file, such as a small image or text document.
- Use the app's own file picker or drag-and-drop area. Note whether the picker appears, whether the selected file loads, and whether the app can export or save a result.
- Repeat the same action in a current version of another browser on the same MacBook, if available. Keep the file, website, and steps the same so the comparison is useful.
For a closer look at one newer browser feature, see How to check File System Access API support. That API is different from the ordinary file picker many websites use.
What the result means
The regular file picker opens and the file loads
Safari can use the standard user-selected file route for this site and file type. The web app receives access to the file you chose, not permission to browse every folder on your Mac. If another file action fails, it may rely on a different API or have a site-specific problem.
The file picker works, but a folder or save feature does not
Web apps can use different browser APIs for opening one file, choosing a folder, keeping access to a file, or saving changes. Support can differ between APIs and Safari versions. A basic file upload working does not prove that a more advanced folder or save workflow is supported.
The same action works in another browser
This points toward a difference in browser support, settings, or the way the site handles Safari. Check the feature the site needs, and look for a Safari-specific message or alternative workflow. It does not automatically mean Safari is broken.
The action fails in every browser
The cause may be the website, the file itself, or the Mac's available storage rather than Safari support. Try a small file in a common format, reload the page, and check whether the site explains its accepted file types or size limits.
How to fix it
- Reload the page and choose the file again. A temporary page error or expired file selection can stop an operation. Avoid using a sensitive document while testing an unfamiliar workflow.
- Update Safari and macOS. Safari updates are included with macOS updates. Open System Settings › General › Software Update to check for an update, then reopen Safari and retry the same action.
- Check Safari's download handling. If the problem is saving a downloaded file, open Safari › Settings › Websites › Downloads and review the setting for the site. Also check the download location in Safari › Settings › General and make sure the destination has free space.
- Allow only the access macOS asks for. When a site opens a file picker, select the file or folder you intend to use. If macOS shows a privacy prompt for a protected folder, allow the requested access if you trust the site and need the feature. Do not grant Full Disk Access just to use a normal file picker.
- Check the app's browser requirements. Some sites document which browsers support their advanced file features. If a feature is unavailable, use the site's standard upload or download option, or use a supported browser for that task.
- Compare with a new browser profile only if needed. Extensions or saved site settings can interfere with a page. Try a private window or a clean profile, while remembering that private browsing can itself limit some site features.
If you are comparing behavior on a Windows 11 computer, Settings › Privacy & security › File system controls access for some Windows apps. It is not a general permission that lets a website browse the computer, and it does not change Safari's support on your MacBook.
What a browser can do with a local file
A web page cannot silently search your Mac for documents. In the usual file-input flow, you pick a file through a dialog and the page can work with the file you selected. Dragging a file onto a page is another user action that gives the page the dropped item.
More advanced browser APIs may let a site work with a chosen file or folder over multiple steps, sometimes with a permission prompt. Browser support for those features can vary. The site also has to request the feature correctly, and your browser must allow it in the context where the page is running.
File access and file upload are not the same thing. A page may process a selected file locally, or it may send data to its own server. Check the site's privacy information before choosing personal files. TooLab's Browser Info reports browser details and supported features, but it does not test every website's file workflow.
