UserAgent.browsers

The browser brands and versions the client reported, as an array of BrandVersion objects built from the Sec-CH-UA-Full-Version-List hint. Recommended.

Currentarray of BrandVersion objectsRecommendedSince 2.6-202204

Field facts

Path
device.sua.browsers
Object
UserAgent
Type
array of BrandVersion objects
Requirement
Recommended
Added
OpenRTB 2.6-202204
Spec section
3.2.29

How it is used

Chromium browsers report several entries: the engine (Chromium), the product (such as Google Chrome or Microsoft Edge), and a deliberately fake GREASE brand such as "Not-A.Brand" that stops parsers from depending on exact lists or order. Passing entries through as received is the safe choice; buyers skip the GREASE entry. Without high-entropy hints, only major versions are available.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "device": {
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "124",
            "0",
            "6367",
            "91"
          ]
        },
        {
          "brand": "Google Chrome",
          "version": [
            "124",
            "0",
            "6367",
            "91"
          ]
        },
        {
          "brand": "Not-A.Brand",
          "version": [
            "99",
            "0",
            "0",
            "0"
          ]
        }
      ]
    }
  }
}

Common mistakes

  • Sending sua with browsers missing or empty. The structured user agent then says nothing about the browser, and RTBlint reports it.
  • Sending a single object instead of an array.
  • Flattening each version into one string such as "124.0.6367.91" instead of an array of components.

Version history

Added in OpenRTB 2.6-202204, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.6-202204Added in the first 2.6 release, published without a structured text archive; the 2.6-202210 republication is the first tagged text.
2.6-202210 to 2.6-202505array of BrandVersion objectsRecommendedNo
2.6-202606array of BrandVersion objectsRecommendedNo

Related fields

Other UserAgent fields

For a walkthrough of the whole object, read User-agent client hints and sua.