Skip to Content
Platform.Ontology

UA Client Hints, low entropy

Browser brand list, mobile flag and OS name that Chromium sends by default.

Gets silentlyDevice detailsClient HintsWeb browsersWhen the page loadsWhile you use it

In one line

Can see your browser brand, whether it is mobile, and your OS name

Browser brand list, mobile flag and OS name that Chromium sends by default.

Three coarse hints (Sec-CH-UA, Sec-CH-UA-Mobile, Sec-CH-UA-Platform) replace most of the old User-Agent. They split the audience into mobile vs desktop and Windows vs macOS vs Android with almost no tracking power.

What it can and can't do

What the user does: Nothing. Chromium sends this with every request

It can

  • See your browser brand list
  • See a yes or no for mobile
  • See whether you use Windows, macOS, Android, or Linux
  • Split visitors into big groups, such as mobile and desktop

It cannot

  • See exact versions or device models
  • Work in Firefox, Safari, or on iPhone
  • Tell you apart from many other visitors
  • See your name, location, or accounts

How it differs between platforms: Chromium browsers send them. Firefox and Safari send the old user agent text instead.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported902021-04-13None
EdgeSupported902021-04-15None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported902021-04-13None
Samsung InternetSupported15.02021-08-13None

How a site asks for it

APInavigator.userAgentData.brands, .mobile, .platform; headers Sec-CH-UA, Sec-CH-UA-Mobile, Sec-CH-UA-Platform
Browser compat keysapi.Navigator.userAgentData
api.NavigatorUAData.brands
api.NavigatorUAData.mobile
api.NavigatorUAData.platform
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
brandslistNone3 or so brand+version pairs incl. one randomized GREASE brand like Not A;Brandmajor version only
mobilebooleanNonetrue or falseNot listed
platformenumNoneWindows, macOS, Linux, Android, Chrome OS, iOS(n/a), UnknownNot listed

Technical limits

  • Chromium family only (Chrome, Edge, Opera, Brave)
  • HTTPS or localhost only
  • Brand list order and GREASE token are randomized per version to stop sniffing

The story

What it is

Three basic facts sent by default: browser brand, phone or not, and operating system name.

For you

You never see these. They ride along with every page request, in the background. They let a site know if you are on a phone or a computer so it shows the right version.

For makers

These replace most of the old user agent. They give just enough to serve mobile or desktop pages and basic OS fixes. They are coarse, so they carry less tracking value.

Where you see it

TypeExampleApps
shoppingA shop sends a mobile layout to phones and a full layout to desktops from the very first request.None named
gamesA game portal picks the mobile or desktop version of a browser game before the page loads.Poki
mediaA news site routes phones to a lightweight version of an article.None named
videoA video site chooses a mobile player on phones and a full player on computers.YouTube
analyticsA traffic dashboard splits visits into mobile and desktop and Windows, Mac and Android.Google Analytics
securityA bot tool compares the brand list with other signals and flags a fake Chrome.Cloudflare

Risks

  • Very coarse
  • Still splits audiences

What the platform says

Good uses and abuse

Legitimate uses

  • Pick download for OS
  • Mobile layout

Known abuse

  • Baseline for fingerprint combos

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits2Rough identifying entropy, when known

History

  • 2021-03, Chrome 89: Sec-CH-UA, Mobile, Platform sent by default on HTTPS
  • 2022-10, Chrome 107: UA string reduction completes the shift of detail to hints

Sources

How well checked: Checked against real behavior.

On this page