User-Agent vs. Client Hints: What Websites Learn About Your Browser

The User-Agent is a browser description included in many web requests. User-Agent Client Hints provide selected browser and platform details through another set of interfaces in supporting browsers. A website may read both.

These are reported descriptions, and browsers can reduce their detail. A familiar version string in a report may therefore be a compatibility value rather than your exact operating-system version.

Learning objectives

After reading this article you will be able to:

  • Recognize the purpose of a User-Agent string
  • Explain why reduced values can be intentional
  • Compare Client Hints with the traditional browser description

What the User-Agent string reports

The string helps servers understand the client making a request.

It commonly contains browser, engine and platform tokens. Historical compatibility requirements mean a token can mention another browser or a generic platform value. Reading every word as a literal inventory produces mistakes.

Changing only the string changes a declaration. It does not automatically replace the graphics engine, supported APIs, font environment or other observable behavior.

Why operating-system and version details may look simplified

Browsers can reduce or freeze parts of the User-Agent to expose less identifying information.

This allows many devices to share the same conventional string. Exact details may be absent or available through a different interface, depending on the browser and request. A reduced platform token alone is not evidence of a broken device configuration.

When investigating a report, record the complete string and browser version. Compare like-for-like fields rather than treating a reduced string and a detailed platform reading as equivalent measurements.

How User-Agent Client Hints differ

Client Hints separate browser information into fields instead of relying only on a long string.

InterfaceTypical roleInterpretation
User-Agent headerTraditional client descriptionMay contain reduced and compatibility tokens
Client Hint request headersSelected browser and platform informationAvailability depends on browser and request context
JavaScript Client Hints interfaceStructured client dataSupport and access vary

Some information is provided with less detail by default; additional values can depend on requests and browser policy. A browser that does not implement this mechanism may still expose information through other APIs.

For managed profiles, inspect the User-Agent, Client Hints and actual browser capabilities together. A label suggesting one platform alongside incompatible capabilities is a more useful investigation target than a harmless reduced token.

Why a browser label is only the starting point

Websites can combine declarations with behavior. Understanding both interfaces helps you explain a report without assuming that changing a browser name changes the whole environment.

Interpreting the result

  • Support differs across browsers and versions.
  • A reduced value may be working as designed.
  • An absent Client Hints field does not mean the browser exposes no other information.

Frequently asked questions

Why does my operating-system version look old?

The User-Agent may use a frozen compatibility token. Check the browser’s reporting policy and compare it with structured platform information where available.

Will changing the User-Agent change my whole fingerprint?

It changes the reported value where the modification applies. Rendering, storage and other APIs need separate consideration.

Why do two test sites name my browser differently?

They may parse different tokens or use different interfaces. Inspect the source fields and detection rules rather than only the final label.

References

Next steps

Canvas: measuring output rather than a label

Check browser and platform fields