Skip to Content
Platform.Ontology

Client Hints (Accept-CH, Critical-CH)

Servers ask the browser for extra device details through request headers.

Gets silentlyNetwork and connectionHeadersWeb browsersWhen the page loads

In one line

Can ask your browser for extra device details such as model, OS version and screen

Servers ask the browser for extra device details through request headers.

A server sends Accept-CH to receive hints such as Sec-CH-UA-Platform-Version, Arch, Bitness, Model, Device-Memory, DPR and Viewport-Width. Critical-CH forces a retry with them. Chromium only; Firefox and Safari do not send them.

What it can and can't do

What the user does: Nothing. It happens when a page loads and the site asks for hints

It can

  • Ask for details such as platform version, device model, memory and screen width
  • Tailor images and pages to your device
  • Make your browser retry the request with those details on sites that require them

It cannot

  • Get these details from Firefox or Safari, which do not send them
  • Get details the browser does not offer; it sends only what the site asks for
  • Know who you are from them alone

How it differs between platforms: Only Chromium browsers (Chrome, Edge, Samsung Internet) send them. Firefox and Safari do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported462015-10-13None
EdgeSupported792020-01-15None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported462015-10-14None
Samsung InternetSupported5.02016-12-15None

How a site asks for it

APIAccept-CH and Critical-CH response headers; Sec-CH-* request headers
Browser compat keyshttp.headers.Accept-CH
How access is grantednone
What the user seesNot listed
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsNot listed
How to take it backNot listed
Inside an iframeNot listed

Typical flow

  1. Server returns Accept-CH
  2. Browser adds hints on later requests
  3. Critical-CH triggers a same-load retry

Data you get

What comes back: One header per hint
Shape: list

FieldTypeUnitRangePrecision
Sec-CH-UA-ModelstringNonedevice model or emptyexact (mobile)
Sec-CH-UA-Platform-VersionstringNoneOS versionexact

Technical limits

  • High entropy hints only sent after server opt-in and to first party by default
  • Third parties need Permissions-Policy delegation

The story

What it is

The server can ask your browser for extra details about your device with each request.

For you

You never see it. When a site asks, your browser quietly sends things like your device model, system version, screen density and memory size. The site then sends the right image size or layout.

For makers

Makers use hints to send the right images, files and layout for each device, which makes pages faster. Fraud and ad systems also use the detail as a fingerprint input, so what a server asks for matters.

Where you see it

TypeExampleApps
gamesA browser game site picks the right graphics quality and download size for a weak phone or a strong gaming laptop.Poki, CrazyGames
gamesA cloud gaming site reads device and screen details to choose the stream resolution and controls.GeForce NOW, Xbox Cloud Gaming
mediaA streaming site picks video quality and app layout for your TV, phone or laptop.Netflix, YouTube
shoppingA store sends smaller images to a low memory phone so the page loads fast.Amazon
adsAn ad system reads device model and system version to match ads to phone models.None named
securityA fraud tool checks that hints agree with the browser claim, and a mismatch reveals a spoofed device.None named
analyticsA product team counts visitors by exact device model and system version.Google Analytics

Risks

  • Reveals device model
  • Used for fingerprinting

What the platform says

Good uses and abuse

Legitimate uses

  • Responsive delivery, correct downloads

Known abuse

  • Gets precise OS and device model without JS

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 bits3Rough identifying entropy, when known

History

  • 2021-03, Chrome 89: UA Client Hints on by default
  • 2022-03, Chrome 100: Critical-CH shipped
  • 2023-06, Chrome 110: User-Agent reduction completes on Android and desktop

Sources

How well checked: Based on official documentation.

On this page