Device.langb

The browser or device language as an IETF BCP 47 tag, such as "en-US" or "zh-Hant", which can express region and script as well as language. Added in OpenRTB 2.6.

CurrentstringOptionalSince 2.6-202204

Field facts

Path: device.langb
Object: Device
Type: string
Requirement: Optional
Added: OpenRTB 2.6-202204
Spec section: 3.2.18

How it is used

Send either language or langb, not both. BCP 47 is the better choice when the distinction matters, for example Traditional versus Simplified Chinese, or Brazilian versus European Portuguese.

Example

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

{
  "id": "req-1",
  "device": {
    "langb": "pt-BR"
  }
}

Common mistakes

Sending both language and langb. They are mutually exclusive, and the validator reports the pair.
Using an underscore, as in "pt_BR". BCP 47 tags use a hyphen.

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.

Versions	Type in the spec	Required	Deprecated
2.6-202204	Added 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-202606	string	No	No