When and Why to Use
Use this when you want respondents to rank a list of items in order of preference, importance, or relevance. Ideal for:
Brand or product preference
Feature prioritization
Behavioral comparisons (e.g. activities, habits)
Supports optional min/max number of items to rank, media options, and custom recoding.
Chat Experience
Drag-and-drop or tap-to-rank UI depending on
styleLabels for top and bottom ranks shown as anchors
Optional "Don't know" button shown below options
Traditional Experience
Grid or stacked ranking interaction optimized for larger viewports
Buttons are laid out clearly with visual feedback on order
Chat experience | Traditional Experience with images | Traditional, mobile optimized, without images |
|
 | 
|
Configuration Options
Option | Type | Required | Default | Description |
|
| yes | - | Text shown above the ranking list |
| `List[str | MediaItem]` | yes | - |
|
| no | all | Minimum number of items user must rank |
|
| no | all | Maximum number of items user may rank |
|
| no | ("Least", "Most") | Anchors for bottom/top of the ranking |
|
| no |
| Shuffle item order |
|
| no | - | Items that should not be shuffled |
|
| no | random | Test-mode ranking order |
|
| no | - | Map items to alternative codes for reporting |
|
| no | - | Adds a "Don't know" option with this label |
| `Callable[[List[str]], str | None]` | no | - |
|
| no |
| Skip if no items to rank |
|
| no | - | Label to use for image-based items |
|
| no |
| Whether to show labels with images |
|
| no | - | Size of image tiles |
|
| no | - | Used for token repla |