Skip to Content
Platform.Ontology

UA Client Hints, high entropy

Detailed device and browser versions a site can request with Accept-CH or a JavaScript call.

Gets silentlyDevice detailsClient HintsWeb browsersWhen the page loadsWhile you use it

In one line

Can see detailed device and browser versions, but only if the site asks

Detailed device and browser versions a site can request with Accept-CH or a JavaScript call.

Returns exact OS version, CPU, bitness, device model and full browser version. Not sent unless the site asks. The browser can decline, but Chrome currently answers without a prompt.

What it can and can't do

What the user does: Nothing. The site asks and Chromium answers without a prompt

It can

  • Get your exact OS version, chip, and 32 or 64 bit
  • Get the Android phone model
  • Get your full browser version
  • Use the detail to serve the right app or ad

It cannot

  • Work in Firefox, Safari, or on iPhone
  • Get anything until the site asks for it
  • See your name, location, or accounts
  • See an iPhone model

How it differs between platforms: Chromium browsers answer without a prompt. Firefox and Safari do not offer these hints.

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 InternetSupported23.02023-10-18None

How a site asks for it

APInavigator.userAgentData.getHighEntropyValues([...]); Accept-CH response header then Sec-CH-UA-* request headers
Browser compat keysapi.NavigatorUAData.getHighEntropyValues
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
platformVersionstringNonee.g. 15.1.0 (macOS), 13.0.0 or higher for Windows 11Not listed
architectureenumNonex86, arm, empty stringNot listed
bitnessenumbits32, 64Not listed
modelstringNoneAndroid model such as Pixel 8, else emptyNot listed
fullVersionListlistNonebrand and full version, e.g. 142.0.7444.604-part version
uaFullVersionstringNonedeprecatedNot listed
wow64booleanNone32-bit browser on 64-bit WindowsNot listed
formFactorslistNoneDesktop, Mobile, Tablet, XR, Automotive, EInk, WatchNot listed

Technical limits

  • Chromium only
  • Site must ask: header needs Accept-CH, JS call per hint
  • Delegation to third parties needs Permissions-Policy
  • Spec lets browsers refuse or lie; Chrome does not prompt today

The story

What it is

Detailed device and browser facts, like exact OS version and model, that a site can ask for.

For you

You never see it. If a site asks, Chrome can hand over exact versions, chip type and device model. In return you get the right installer, the right layout or fewer bugs.

For makers

The older user agent gave out everything. With hints, sites must ask, which gives the browser a chance to say no. Ad tech and fraud teams still ask for many hints, since together they are a rich device profile.

Where you see it

TypeExampleApps
developerA download page asks for CPU type and OS version to give the right installer.Zoom, Slack
gamesA browser game asks for model and platform version to choose graphics settings that work on that device.None named
adsAn ad exchange asks for full device details so bidders can target by model and OS version.Google Ad Manager
securityA bank asks for the full browser version to check it against known fakes.None named
analyticsA product team logs device model and OS version to prioritise fixes.Sentry
mediaA streaming site asks for platform version to pick the right DRM level.Netflix
enterpriseAn IT dashboard reads exact versions to find outdated work laptops.None named

Risks

  • Rich device profile
  • Many sites ask for everything

What the platform says

Good uses and abuse

Legitimate uses

  • Serve correct 64-bit installer
  • Debug crashes by exact version
  • Windows 11 detection

Known abuse

  • Precise device fingerprint without any prompt
  • Targeting by exact model on Android

Scores

ScoreValueMeaning
Sensitivity2 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 bits5Rough identifying entropy, when known

A real example: LinkedIn

user_agent_data source is part of mainstream fingerprint libraries; LinkedIn's list is mostly legacy navigator.* fields (not confirmed for getHighEntropyValues).

History

  • 2021-03, Chrome 89: getHighEntropyValues shipped
  • 2021-05, Chrome 90: wow64 hint added
  • 2022-10, Chrome 107: Becomes the only way to get OS minor version, arch, model after UA reduction

Sources

How well checked: Checked against real behavior.

On this page