Local Font Access
Asks to list every font installed on the device.
In one line
Can list the fonts installed on your computer, after you allow it
Asks to list every font installed on the device.
Reveals the full list of installed fonts and raw font files, which identifies the device and installed software. Gated by prompt because font lists were a long-standing fingerprint.
What it can and can't do
What the user does: You tap a font picker button and choose Allow when Chrome asks
It can
- See the names of all installed fonts
- Open the font files so the page can use them
- Show your own fonts in a design or editing tool
It cannot
- Do this without a tap and your Allow
- See the list in Firefox or Safari
- Keep access after you pick Block
How it differs between platforms: Chrome and Edge on desktop only. Firefox, Safari and phones do not support it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 103 | 2022-06-21 | None |
| Edge | Supported | 103 | 2022-06-23 | 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 | window.queryLocalFonts({postscriptNames}); FontData.blob() |
| Permission name | local-fonts |
| Permissions policy | local-fonts |
| Browser compat keys | api.Window.queryLocalFonts |
| How access is granted | prompt |
| What the user sees | Chrome prompt: See fonts on your device, Allow or Block; needs a gesture. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Persistent per origin |
| How to take it back | Site settings |
| Inside an iframe | Needs allow="local-fonts" in iframes |
Typical flow
- User gesture
- queryLocalFonts()
- Permission prompt
- Array of FontData with family, fullName, postscriptName, style, blob()
Data you get
What comes back: Installed fonts
Shape: list
How often: on call
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
family, fullName, postscriptName, style | string | text | any | name |
blob | binary | bytes | font file | raw |
Technical limits
- Chromium desktop only
- Needs gesture and prompt
The story
What it is
A site asks to list the fonts installed on your computer.
For you
A prompt asks whether the site can see fonts on your device. If you allow, it can list them and use them in your design. If you say no, you only get the standard web fonts.
For makers
Design and publishing tools need access to a person's own fonts, especially brand fonts. The same list of fonts is a strong fingerprint, which is why browsers ask first.
Where you see it
| Type | Example | Apps |
|---|---|---|
| creative | A web design tool lets a designer pick a licensed brand font that is installed on their laptop. | Figma, Canva |
| productivity | A web document editor shows a user's own fonts so a file looks the same as on the desktop. | Google Docs, Word for the web |
| creative | A photo or video web editor loads installed fonts so titles match a project made earlier on the desktop. | Photopea |
| games | A level editor or branded card game maker uses local fonts for custom text in a creation tool. | None named |
| analytics | A fingerprinting script reads the list of fonts to build a nearly unique ID for the device. | None named |
| security | A fraud tool compares fonts with the claimed device model, since a Mac should not show Windows fonts. | None named |
Risks
- Font list identifies your device
- Exposes installed software
What the platform says
- Google Chrome: Local Font Access API. Chrome pitches it as a way for design and editing web apps to use fonts installed on the computer, as desktop apps do.
Good uses and abuse
Legitimate uses
- Design tools
Known abuse
- Font fingerprinting
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | 8 | Rough identifying entropy, when known |
History
- 2022-06, Chrome 103: queryLocalFonts ships
Sources
How well checked: Based on official documentation.