Skip to Content
Platform.Ontology

Local Font Access

Asks to list every font installed on the device.

Asks you firstTyping and clipboardFontsWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported1032022-06-21None
EdgeSupported1032022-06-23None
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

APIwindow.queryLocalFonts({postscriptNames}); FontData.blob()
Permission namelocal-fonts
Permissions policylocal-fonts
Browser compat keysapi.Window.queryLocalFonts
How access is grantedprompt
What the user seesChrome prompt: See fonts on your device, Allow or Block; needs a gesture.
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPersistent per origin
How to take it backSite settings
Inside an iframeNeeds allow="local-fonts" in iframes

Typical flow

  1. User gesture
  2. queryLocalFonts()
  3. Permission prompt
  4. Array of FontData with family, fullName, postscriptName, style, blob()

Data you get

What comes back: Installed fonts
Shape: list
How often: on call

FieldTypeUnitRangePrecision
family, fullName, postscriptName, stylestringtextanyname
blobbinarybytesfont fileraw

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

TypeExampleApps
creativeA web design tool lets a designer pick a licensed brand font that is installed on their laptop.Figma, Canva
productivityA 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
creativeA photo or video web editor loads installed fonts so titles match a project made earlier on the desktop.Photopea
gamesA level editor or branded card game maker uses local fonts for custom text in a creation tool.None named
analyticsA fingerprinting script reads the list of fonts to build a nearly unique ID for the device.None named
securityA 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

Good uses and abuse

Legitimate uses

  • Design tools

Known abuse

  • Font fingerprinting

Scores

ScoreValueMeaning
Sensitivity3 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bits8Rough identifying entropy, when known

History

  • 2022-06, Chrome 103: queryLocalFonts ships

Sources

How well checked: Based on official documentation.

On this page