The ranking field stores all declared option IDs in the respondent's chosen order.
Options and validation
Ranking fields require an options array. Each option has a stable id and a visible label, and a valid answer contains every option exactly once. There's no allowOther, partial ranking, or configurable top-N cut.
The stored value is an array such as ["reliability", "speed", "price"], from first choice to last choice.
Add a ranking field
In the dashboard, select Add block, choose Ranking, and add the choices respondents must order.
ts
const prioritiesField = {
id: "priorities",
kind: "ranking",
label: "Rank what matters most",
options: [
{ id: "speed", label: "Speed" },
{ id: "reliability", label: "Reliability" },
{ id: "price", label: "Price" },
],
required: true,
} as const;Ranking fields can't be prefilled from URL parameters.
Related
- Select: Ask for one preference instead of a complete order.
- Multi-select: Let respondents choose several items without ordering them.
- Responses and insights: Review and export ordered answers.