Refresh.refsettings

Array of RefSettings objects, each describing one refresh trigger and its minimum interval. Recommended. A slot that refreshes both on a timer and on user action lists two entries.

Currentobject arrayRecommendedSince 2.6-202303

Field facts

Path: imp.refresh.refsettings
Object: Refresh
Type: object array
Requirement: Recommended
Added: OpenRTB 2.6-202303
Spec section: 3.2.33

Example

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

{
  "id": "req-1",
  "imp": [
    {
      "refresh": {
        "refsettings": [
          {
            "reftype": 3,
            "minint": 30
          }
        ]
      }
    }
  ]
}

Common mistakes

Sending a single RefSettings object instead of an array. The spec table describes it in the singular but types it as an object array.

Version history

Added in OpenRTB 2.6-202303, 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.6-202303	Listed in this release's notes; IAB's tagged spec file for it does not include the field yet.
2.6-202309 to 2.6-202606	object array	Recommended	No