Home Docs Dropdown

Dropdown Input

Allow players to select from predefined options.

Overview

The dropdown field type lets players choose one option from a predefined list. This ensures consistent data collection and makes analysis easier.

Best for: Difficulty levels, platform selection, age groups, game modes, or any choice from a fixed set of options.

Field Structure

key
string required

Unique identifier for this field.

label
string required

Display label shown to the player.

type
string required

Must be set to dropdown

options
array required

Array of string values representing the available choices. Maximum 10 options.

value
string required

The selected option. Must exactly match one of the values in the options array.

Example

{
  "key": "difficulty",
  "label": "What difficulty did you play on?",
  "type": "dropdown",
  "options": ["Easy", "Medium", "Hard", "Expert"],
  "value": "Medium"
}

Additional Examples

Platform Selection

{
  "key": "platform",
  "label": "What platform are you playing on?",
  "type": "dropdown",
  "options": ["PC", "PlayStation", "Xbox", "Nintendo Switch", "Mobile"],
  "value": "PC"
}

Age Group

{
  "key": "age_group",
  "label": "What's your age group?",
  "type": "dropdown",
  "options": ["Under 18", "18-24", "25-34", "35-44", "45+"],
  "value": "25-34"
}

Game Mode

{
  "key": "game_mode",
  "label": "Which mode do you prefer?",
  "type": "dropdown",
  "options": ["Story Mode", "Survival", "Creative", "Multiplayer"],
  "value": "Multiplayer"
}

Validation Rules

  • The options array is required and must contain at least 1 option
  • Maximum of 10 options per dropdown
  • Each option must be a string with maximum 255 characters
  • The value must exactly match one of the options (case-sensitive)
  • Value cannot be empty or null

Important: The selected value must match the option text exactly, including capitalization. For example, if your option is "Easy", the value must be "Easy" not "easy".

Common Use Cases

Game Settings

Difficulty levels, graphics quality, control schemes, or game modes.

Demographics

Age groups, regions, languages, or player experience levels.

Platform Information

Gaming platform, device type, operating system, or screen resolution.

Preferences

Favorite characters, preferred play styles, or content preferences.

Previous
Text
Next
Checkbox