Ranking

Type key: ranking. Renders a list of options that respondents drag into their preferred order. In the editor this is the Ranking block.

A question with options: the question rules and option rules apply, and it can sit in a layout row column.

Meta fields

The meta fields of this node type are listed in the request body of Replace the draft document, under pages › nodes, in the ranking tab.

Example

A minimal Ranking node

{
  "public_id": "nRnk",
  "sort_order": 1,
  "type": "ranking",
  "meta": {
    "question": "<span>Rank the sessions you want to see</span>",
    "select_options_data": [
      {
        "value": "keynote",
        "label": "Keynote"
      },
      {
        "value": "workshop",
        "label": "Workshop"
      },
      {
        "value": "panel",
        "label": "Panel"
      }
    ],
    "validation": {
      "required": false
    }
  }
}

Defaults and rules

• Respondents rank every option, so the node has no default_value. The starting order is the option order, or a per-respondent shuffle when select_options_randomize is true.
• Ranking has no “Other” option.