Content.genres

Genre IDs for the content, taken from the taxonomy named by Content.gtax. When gtax is absent, the IDs come from the CTV Genre Mapping subset of IAB Content Taxonomy 3.1. Added in 2.6-202501.

Currentstring arrayOptionalSince 2.6-202501

Field facts

Path
app.content.genres, dooh.content.genres, site.content.genres
Object
Content
Type
string array
Requirement
Optional
Added
OpenRTB 2.6-202501
Spec section
3.2.16

How it is used

Its declared type has moved between snapshots: the archived 2.6-202505 table lists a plain string, and 2.6-202606 lists an array of strings. Send an array of string IDs, since Content Taxonomy 3.x IDs are not all numeric, and confirm what partners pinned to older snapshots expect. The implementation guidance for this field pair is Section 7.13 of the IAB guide.

Example

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

{
  "id": "req-1",
  "app": {
    "content": {
      "genres": [
        "483"
      ]
    }
  }
}

Common mistakes

  • Sending genre names such as "Drama" instead of taxonomy IDs.
  • Sending integers instead of strings. The current type is a string array.
  • Validating an array against the 2.6-202505 snapshot, whose catalog row expects a single string, and reading the type mismatch as a payload bug. Against 2.6-202606 the array is correct.

Version history

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

VersionsType in the specRequiredDeprecated
2.6-202501Listed in this release's notes; IAB's tagged spec file for it does not include the field yet.
2.6-202505stringNoNo
2.6-202606string arrayNoNo

Related fields

Other Content fields

For a walkthrough of the whole object, read CTV and ad pods.