Skip to Content
Platform.Ontology

User-Agent string

The browser's self-description sent on every request and readable in JavaScript.

Gets silentlyDevice detailsBrowser identityWeb browsersWhen the page loadsWhile you use it

In one line

Can see your browser brand, version, OS family, and chip family on every request

The browser's self-description sent on every request and readable in JavaScript.

Tells the site browser brand and major version, OS family, and CPU family. Used for compatibility and bot filtering. Since UA reduction the string is coarse, so finer detail moved to opt-in Client Hints.

What it can and can't do

What the user does: Nothing. Your browser sends it with every page request

It can

  • See the browser brand and major version
  • See the OS family and chip family
  • Choose a layout or fix that suits it
  • Block or flag likely bots

It cannot

  • See finer detail; Chrome now keeps that in opt in hints
  • See your exact device model
  • Be sure it is true; tools can fake it
  • See your name, location, or accounts

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported12008-12-11None
EdgeSupported122015-07-29None
FirefoxSupported12004-11-09None
SafariSupported12003-06-23None
Safari on iPhoneSupported12007-06-29None
Chrome on AndroidSupported182012-06-27None
Samsung InternetSupported1.02013-04-27None

How a site asks for it

APInavigator.userAgent, navigator.appVersion, User-Agent request header
Browser compat keysapi.Navigator.userAgent
api.Navigator.appVersion
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
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
userAgentstringcharsabout 70 to 200 charsChromium reduced: major version only, minor zeroed
OS tokenstringNoneWindows NT 10.0; Win64; x64 | Macintosh; Intel Mac OS X 10_15_7 | X11; Linux x86_64 | Android 10; K | iPhone OS 18_xfrozen since Chrome 107 desktop, Chrome 110 Android
Firefox rvstringNonerv:109.0 on Firefox 110 and laterfrozen at 109

Technical limits

  • Cannot reliably state exact OS minor version on Chromium, Safari or Firefox
  • Can be spoofed trivially by extensions or DevTools
  • iPadOS 13+ reports Macintosh, not iPad

The story

What it is

The browser's own description of itself, sent on every request and readable by scripts.

For you

You never see it. It rides along every time you open a page. It lets the site pick the right version, like a phone layout or a desktop layout, and sort out bots.

For makers

Compatibility, bot filtering and basic analytics all start here. With reduction, the string is coarse, so more people look the same. Makers often combine it with other signals to check whether a visitor is who they claim to be.

Where you see it

TypeExampleApps
developerA web app shows a banner for a browser version that is too old to run it.None named
securityA web firewall blocks traffic from strings known to belong to scrapers.Cloudflare
adsAn ad server filters out crawlers by their strings so advertisers are not charged for them.Google Ad Manager
analyticsA product team reads strings to decide which browsers still deserve support.None named
gamesA browser game shows a message to people on a browser with no WebGL.None named
mediaA video player picks the right format for Safari versus Chrome.YouTube
enterpriseAn IT team blocks company logins from unapproved browsers.None named

Risks

  • Easy to fake
  • Combines with other signals

What the platform says

Good uses and abuse

Legitimate uses

  • Serve right code path
  • Block outdated browsers
  • Bot scoring

Known abuse

  • Combined with other signals for tracking
  • Unmasking version for exploit targeting

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

A real example: LinkedIn

Collected as userAgent, appName, appCodeName, appVersion, product, productSub, vendor. Read by the LinkedIn APFC fingerprint script (48 features, alleged by BrowserGate, partly confirmed by BleepingComputer).

History

  • 2020-09, Safari 14: macOS token already frozen at 10_15_7 (Big Sur and later still report it)
  • 2022-05, Chrome 101: Minor, build and patch version zeroed in UA string (101.0.0.0)
  • 2022-10, Chrome 107: Desktop OS and CPU frozen to Windows NT 10.0, Intel Mac OS X 10_15_7, Linux x86_64
  • 2023-02, Chrome 110: Android version frozen to 10 and device model replaced by K; phase complete by Chrome 113
  • 2023-02, Firefox 110: Gecko rv version frozen at 109.0

Sources

How well checked: Checked against real behavior.

On this page