BidRequest.wlang
An allow list of creative languages as ISO 639-1 two-letter codes. Added in 2.5; leaving it out means no language restriction.
Field facts
- Path
wlang- Object
- BidRequest
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.5
- Spec section
- 3.2.1
How it is used
Without it, buyers can look at Device.language and Content.language to choose a creative. Send either wlang or its BCP 47 counterpart, BidRequest.wlangb, not both.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"wlang": [
"en",
"es"
]
}Common mistakes
- Regional tags such as en-US in this list. Those belong in
wlangb. - Sending both
wlangandwlangb(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 array | No | No |
| 2.6-202210 to 2.6-202606 | string array | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.