Skip to main content

Search

Rank questions

  • Updated

The rank question type allows respondents to rank a set of items against each other using the type: rank tag.

Details

  • If no rank tag is present, the rank widget will create as many ranks as there are items in the list.
  • When using standalone lists (setlists) or sheets, you can reference the list source with either optsfrom or itemsfrom tags.
  • The number of required ranks can be conditional by placing an "if statement" (condition decorator) on the list. When a condition is present, the rank question will only show as many ranks as there are items.
  • To use non-default ranks, include the ranks tag and list the ranks within a heredoc. The presentas: pulldown tag must also be included.
  • Lists with nested orderings and multiple collections are not supported. Always test your referenced list thoroughly.

Tags

The following table contains programming tags unique to the rank question type. 

Most common tags
Tag Description Input

rank

 Specifies the number of ranks that can be assigned. Number, logical operator with number, range, or variable reference

ranks

 Used to specify an inline list of alternative ranks instead of the default numeric rank assignments. Must include heredoc. Option IDs with option text 
optsfrom

Specifies where the list of items is being called from. This tag is interchangeable with itemsfrom. 

 Setlist, derived list, spreadsheet, or question label shorthand
Other tags
Tag Description Input
item id separator

Specifies a different character to separate widget ID from item (option) ID in item variable name.

Be sure to use a unique input from rank id separator.

Alphanumeric characters or underscore; default is 'R'
present as

Changes the desired output style from buttons to pulldowns in Modern-based and Flex themes. 

In basic themes, this changes the ranking style from pulldowns to buttons.

This tag is required if using alternative rank text.

pulldown

button
rank id separator

Specifies a different character to separate the widget ID from rank code in derived variable name.

Be sure to use a unique input from item id separator.

 Alphanumeric characters or underscore; default is 'RANK'
rankmessage Defines the message to display to respondents fail to rank the items correctly.

Any text, with syntax/code
ranksfrom

Specifies where the rank list is being called from (e.g., ranksfrom: LIST1 or ranksfrom: Q3.ranks).

 A list from a previous ranking question, list, or spreadsheet, or the series function
Reporting tags
Tag Description Input
itemchapter Indicates the chapter where the ranking widget's item (option) fields appear. Chapter ID; e.g., 'A1'
rankingchapter Indicates the chapter where the derived RANK variables appear. Chapter ID; e.g., 'A1'
rankingdesc Specifies the iterative description which appears for each rank as the rows in the RANK summary tile.

Text, option data such as '[id]', '[text]', etc.
ranksdesc Specifies the title for the derived RANK summary tile. Text

Tip! Table formatting tags can be included with pulldown ranking questions. See below for example.

Additional examples

Allow a range of ranks

To enforce a single ranking but allow up to a specific number of items to be ranked, specify a range with the rank tag.

Rank an amount that varies

The rank tag also can accept a value that changes on a per-respondent basis by inserting a previous question's response with piping.

Using alternative ranks

When non-traditional ranks are needed, you can create either an inline list with heredoc in the ranks tag or use a setlist with ranksfrom. The present as: pulldown tag is required.

Pulldown rankings with table formatting

Pulldown ranking questions can accept table formatting tags so that they look more like tables to respondents.

Related to

Related articles

Comments

0 comments

Please sign in to leave a comment.