Bid.language

The language of the creative as an ISO 639-1 two-letter code, or the nonstandard code xx when the creative has no words. Added in 2.5; send either this or Bid.langb.

CurrentstringOptionalSince 2.5

Field facts

Path: seatbid.bid.language
Object: Bid
Type: string
Requirement: Optional
Added: OpenRTB 2.5
Spec section: 4.2.3

How it is used

Exchanges compare it with BidRequest.wlang. The code xx tells the exchange that a logo-only creative has no language to match.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "language": "en"
        }
      ]
    }
  ]
}

Common mistakes

A regional tag such as en-GB here. That belongs in Bid.langb.
Sending both language and langb (openrtb.fields.mutually_exclusive).

Version history

Added in OpenRTB 2.5, 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.5	string	No	No
2.6-202210 to 2.6-202606	string	No	No

Related fields

Other Bid fields

For a walkthrough of the whole object, read Bid response anatomy.