Question Type: select_question

When and Why to Use

Use this when you need a single-select multiple-choice question. It's suitable for:

Categorical data collection (e.g. gender, preferences, ratings)
Recoding responses into other groupings
Displaying image-based choices
Allowing "Other (please specify)" options

Supports randomization, disabling options, and custom input.

Portrait Experience

Options appear as buttons or image tiles depending on input.
If specify_option is set, an input field appears when selected.
Disabled options appear greyed out and cannot be selected.

Landscape Experience

Layout may adjust to grid view or left-right image-plus-label design.
Keyboard/remote navigation highlights each choice.
Specify input field appears inline or in modal depending on UI.

Configuration Options

Option	Type	Required	Default	Description
`question`	`string`	yes	-	The prompt shown to the user
`options`	`List[str	MediaItem]`	yes	-
`image`	`MediaItem`	no	-	Image shown above the question
`randomize`	`bool`	no	`False`	Shuffle options (except fixed ones)
`fixed_options`	`List[str]`	no	-	Options that remain in place even when randomizing
`disabled_options`	`List[str]`	no	-	Options to grey out/disable
`specify_option`	`str`	no	-	Adds an "Other" option requiring input
`specify_text`	`str`	no	"Please specify"	Prompt shown with specify_option
`default`	`str`	no	random choice	Test data default
`recodes`	`Dict[str, str]`	no	-	Maps response(s) to grouped value(s)
`custom_validator`	`Callable[[str], str	None]`	no	-
`skip_empty`	`bool`	no	`False`	If `True`, skips the question when no options available
`image_label_field`	`str`	no	-	Field used to label image options from media items
`show_image_label`	`bool`	no	`True`	Whether to show labels with image tiles
`image_size`	`Tuple[int, int]`	no	-	Pixel bounding box for rendering image options
`**topics`	`dict`	no	-	Replaces tokens in `question` and groups results in reports

Example Code

Basic usage:

s.select_question("What is your gender?", options=["Male", "Female", "Non-Binary"])

With disabled and specify:

s.select_question( "What did you enjoy most?", options=["Service", "Price", "Speed"], disabled_options=["Speed"], specify_option="Other", specify_text="Tell us what else you enjoyed" )

With custom validator:

s.select_question( "Which brand do you trust the most?", options=["Brand A", "Brand B", "Brand C"], custom_validator=lambda x: "Are you sure you meant Sleepy Cows?" if x == "Sleepy Cows" else None )

Notes

randomize helps reduce bias, especially in brand lists.
Use fixed_options to keep options like "None of the above" in place.
specify_option is useful for letting users add their own answers.
Recoding allows multiple options to be grouped into analysis buckets.

Question Type: multi_select_question

Question Type: grid_multi_select_question

Question Type: grid_rating_question

Question Type: grid_numeric_question

Question Type: ranking_question