Skip to content

Ranking

Lets respondents drag and drop options into their preferred order. Uses choice.subType set to "ranking".

See the Ranking field help article for builder options.

Schema

FieldTypeDescription
choice.subType"ranking"Drag-and-drop ranking
choice.optionsarrayItems to rank, each with text and _id

Submission answers for ranking fields preserve the order the respondent assigned.

{
  "_id": "6a0ef83b3affac35058b0739",
  "questionType": "choice",
  "question": "Ranking question",
  "displayOrder": 6,
  "isRequired": false,
  "isDeleted": false,
  "isActive": false,
  "choice": {
    "subType": "ranking",
    "options": [
      { "text": "Option 1", "_id": "6a0ef83b3affac35058b0734" },
      { "text": "Option 2", "_id": "6a0ef83b3affac35058b0735" },
      { "text": "Option 3", "_id": "6a0ef83b3affac35058b0736" },
      { "text": "Option 4", "_id": "6a0ef83b3affac35058b0737" },
      { "text": "Option 5", "_id": "6a0ef83b3affac35058b0738" }
    ],
    "_id": "6a0ef88ba7a40272efec3c79"
  }
}