Linearity modes

Linearity Modes tells the buyer which kind of VAST creative the player expects: a linear ad that takes over the player for its duration, or a non-linear ad such as an overlay shown while the content keeps playing. It is sent in Video.linearity, and when the field is absent both kinds are allowed.

List: Linearity Modes2 valuesUsed by imp.video.linearity

Values

ValueNameWhat it means
1LinearLinear: the ad takes over the player for its duration, as in pre-, mid-, post-roll, and outstream video.
2Non-Linear (i.e., Overlay)Non-linear: an overlay or similar unit shown over or around content while it keeps playing.

Fields that use this list

How to use it

Linearity describes the creative, not the inventory. The 2.6 spec says this directly and points readers to Video.plcmt for the placement type. A pre-roll and an outstream unit both take linear creative; an overlay banner on a playing video is non-linear. OpenRTB 2.0 and 2.1 marked the field required, it became optional in 2.2, and the old label Linear / In-Stream lost its in-stream qualifier when the list moved to AdCOM, which removed a long-standing source of confusion.

Common mistakes

  • Using linearity as a placement signal, for example sending 2 for outstream video. Outstream video is linear creative; the placement belongs in Video.plcmt.
  • Sending 0 to mean both kinds. 0 is not in the list; leave the field out to allow both.

Validation

On OpenRTB 2.6 snapshots, RTBlint reports a value outside this list as openrtb.value.invalid. Paste a request into the tester to check the values you send.

Related lists

All lists are on the enumerated lists index.