Content.language

The content's language as a two-letter ISO 639-1 code, such as en or es. Added in OpenRTB 2.1.

CurrentstringOptionalSince 2.1

Field facts

Path: app.content.language, dooh.content.language, site.content.language
Object: Content
Type: string
Requirement: Optional
Added: OpenRTB 2.1
Spec section: 3.2.16

How it is used

It describes the content, not the viewer's device setting, which belongs in Device.language. When the language needs a region or script, use Content.langb instead and send only one of the two.

Example

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

{
  "id": "req-1",
  "app": {
    "content": {
      "language": "en"
    }
  }
}

Common mistakes

Sending a locale such as en-US here. Two-letter codes go in language and full tags in langb.
Sending three-letter codes such as eng.

Version history

Added in OpenRTB 2.1, 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.1	string	No	No
2.2	string co	No	No
2.3 to 2.3.1	string	No	No
2.4	string	No	No
2.5 to 2.6-202606	string	No	No