Skip to main content

Question-Specific Properties

Question-specific properties are unique to individual question types. They provide specialised configuration options that appear only when a particular question type is selected in the canvas. For properties shared across all question types, see Question Common Properties.

caution

There is no autosave feature. Click Save at the top of the page regularly to preserve your progress.

General

  • Autocomplete Type — Specifies the browser autofill category for the input, enabling suggestions such as names, emails, or addresses to speed up data entry.

Rating Scale​

Layout

  • Display Mode — Controls how rating options are presented to respondents:
    • Auto — Automatically selects the best display based on available space.
    • Buttons — Displays each rating option as a button.
    • Dropdown — Displays rating options within a dropdown list.

Rate Values

  • Rate Type — Defines how rating options are visually presented:
    • Labels — Numeric or text-based values (e.g., 1–5).
    • Stars — Star icons for rating.
    • Smileys — Emoji-style rating icons.
  • Rate Count — Specifies the total number of rating options.
  • How to Specify Rate Values — Determines how rating values are defined:
    • Generate — Automatically creates values based on the range and step.
    • Enter manually — Allows you to define custom values and labels.
  • Minimum Rate Value — Sets the starting value of the rating scale (e.g., 1 for a 1–5 scale).
  • Maximum Rate Value — Sets the highest value of the rating scale (e.g., 5 for a 1–5 scale).
  • Rate Step — Defines the increment between values (e.g., a step of 1 creates values 1, 2, 3, 4, 5).
  • Minimum Rate Value Description — Adds a label or description to the lowest value.
  • Maximum Rate Value Description — Adds a label or description to the highest value.
  • Display Rate Descriptions as Extreme Values — Displays the minimum and maximum descriptions at the ends of the scale.

Image Picker​

General

  • Content Mode — Defines whether the options are displayed as images or videos.
  • Image Fit — Controls how images are scaled within their container (e.g., fit inside, fill, or crop).
  • Minimum Image Width / Maximum Image Width — Sets the allowed width range for displayed images to control layout consistency.
  • Minimum Image Height / Maximum Image Height — Sets the allowed height range for displayed images to ensure uniform appearance.
  • Image Height / Image Width — Defines fixed dimensions for images. If set to auto, images adjust based on their original size and container.
  • Allow Multiple Selection — Enables users to select more than one image option.
  • Show Image Captions — Displays text labels or captions below each image option.

Ranking​

General

  • Select to Rank Enabled — Allows respondents to select items in a preferred order instead of dragging them. Users can click options to assign their ranking sequence, making the interaction simpler and more accessible compared to drag-and-drop.

Multi-Select Dropdown​

General

  • Close the Dropdown After Selection — Automatically closes the dropdown list after a user selects an option. When disabled, the dropdown remains open, allowing users to select multiple options without reopening it each time.

Yes/No (Boolean)​

General

  • "True" Label — Defines the text displayed for the positive (true) option (e.g., Yes, Agree, Enabled).
  • "False" Label — Defines the text displayed for the negative (false) option (e.g., No, Disagree, Disabled).

Data

  • "True" Value — Defines the value stored in survey results when the respondent selects the true option.
  • "False" Value — Defines the value stored in survey results when the respondent selects the false option.

File Upload​

General

  • Source Type — Specifies where files can be uploaded from:
    • Local files — Upload files from the user's device.
    • Camera — Capture and upload files directly using the device camera.
    • Local files or camera — Allow both file upload and camera capture.
  • Allow Multiple Files — Enables users to upload more than one file.
  • Preview Images — Displays a preview of uploaded image files.
  • Accepted File Types — Defines which file formats are allowed (e.g., .jpg, .png, .pdf).
  • Show Preview Area — Displays a dedicated area for previewing uploaded files.
  • Store File Content in JSON Result as Text — Saves the file content directly in the survey results as encoded text, instead of storing only a reference.
  • Maximum File Size (in bytes) — Limits the size of files that can be uploaded.
  • Image Height / Image Width — Defines the display dimensions for image previews.
  • Wait for the Upload to Complete — Ensures the file is fully uploaded before allowing the respondent to proceed.
  • Confirm File Deletion — Prompts users to confirm before removing an uploaded file.
  • Allow Camera Access — Allows users to capture and upload images directly using their device camera.

Single-Line Input​

General

  • Input Type — Defines the type of data the input field accepts, determining the format and validation of the entered value.
  • Autocomplete Type — Specifies the browser autofill category for the input, enabling suggestions such as names, emails, or addresses.
  • Data List — Provides a predefined list of suggested values for the input field. Suggestions appear as users type but do not restrict them to those options.

Layout

  • Input Field Size (in characters) — Specifies the visible width of the input field in terms of character count.

Data

  • Update Text Question Value — Controls when the entered text value is updated and applied within survey logic and dynamic expressions:
    • Inherit — Follows the survey's default behaviour.
    • On blur — Updates the value when the input field loses focus.
    • While typing — Updates the value in real time as the user types.

Long Text​

Layout

  • Rows — Defines the initial height of the text area by specifying the number of visible text lines.
  • Auto Grow — Automatically expands the text area as the respondent types more content.
  • Allow Resizing — Enables respondents to manually resize the text area by dragging its corner.

Data

  • Update Text Question Value — Controls when the entered text value is updated and applied within survey logic and dynamic expressions:
    • Inherit — Follows the survey's default behaviour.
    • On blur — Updates the value when the input field loses focus.
    • While typing — Updates the value in real time as the user types.

Multiple Textboxes​

Layout

  • Item Size — Defines the width of each individual input field within the multiple textboxes question.

Single-Select Matrix​

Layout

  • Show Column Headers — Displays or hides the column titles at the top of the matrix.
  • Vertical Alignment — Controls how content within matrix cells is aligned vertically.
  • Alternate Rows — Applies alternating background styles to rows to improve readability.
  • Minimum Column Width (in CSS-accepted values) — Sets the minimum width for each column to ensure proper spacing and layout.
  • Row Header Width (in CSS-accepted values) — Defines the width of the row header (left-side labels for each row).

Multi-Select Matrix​

General

  • Cell Type — Defines the type of input used within each cell (e.g., dropdown, checkbox, radio button, text input).
  • Detail Panel Location — Controls where additional details for a selected row are displayed:
    • Hidden — The detail panel is not displayed.
    • Under the row — The detail panel appears directly below the selected row.
    • Under the row, only one panel is visible — The detail panel appears below the selected row, but only one panel can be open at a time.
  • Total Row Text — Specifies the label for a summary row, typically used to display totals or aggregated values.
note

After selecting a Cell Type, each cell can be configured individually. Click the edit option on a cell to access its own set of properties.

Validation

  • "Non-unique key value" Error Message — Defines the message displayed when duplicate values are entered in fields that require unique entries.

Dynamic Matrix​

General

  • Cell Type — Defines the type of input used within each cell (e.g., dropdown, checkbox, radio button, text input).
  • Detail Panel Location — Controls where additional details for a selected row are displayed:
    • Hidden — The detail panel is not displayed.
    • Under the row — The detail panel appears directly below the selected row.
    • Under the row, only one panel is visible — The detail panel appears below the selected row, but only one panel can be open at a time.
  • Allow Adding Rows — Enables respondents to add new rows dynamically while completing the survey.
  • Allow Removing Rows — Allows respondents to delete existing rows they have added.
  • Allow Row Drag and Drop — Lets respondents reorder rows by dragging and dropping them.
  • Row Count — Sets the initial number of rows displayed when the survey loads.
  • Minimum Row Count — Defines the minimum number of rows that must remain in the matrix.
  • Maximum Row Count — Limits the maximum number of rows that can be added.
  • Add Row Button Location — Controls where the Add Row button is displayed:
    • Depends on matrix layout — Placement follows the overall layout settings.
    • Top — Button appears above the matrix.
    • Bottom — Button appears below the matrix.
    • Top and bottom — Button appears in both locations.
  • Add Row Button Text — Customises the label displayed on the button used to add new rows.
  • Remove Row Button Text — Defines the label for the button used to delete a row.
  • Confirm Row Deletion — When enabled, prompts users to confirm before a row is removed.
note

After selecting a Cell Type, each cell can be configured individually. Click the edit option on a cell to access its own set of properties.

Data

  • Set Default Row Value — Allows you to define default values for each column in a newly added row.
  • Take Default Values from the Last Row — Copies the values from the most recently added row and uses them as defaults for the next new row.

Validation

  • "Non-unique key value" Error Message — Defines the message displayed when duplicate values are entered in fields that require unique entries.
  • Key Column — Specifies which column is used as a unique identifier for each row, ensuring values in that column are unique across all rows.

Panel​

Layout

  • Element Order on the Page — Controls how questions inside the panel are ordered when displayed:
    • Inherit — Uses the default survey or page setting.
    • Initial — Displays elements in the order they were created.
    • Random — Randomises the order of elements each time the survey is loaded.
  • Add Outer Indents — Adds spacing around the panel container, shifting it inward from surrounding elements.
  • Add Inner Indents — Adds spacing inside the panel, increasing the margin between the panel border and its internal content.

Dynamic Panel​

General

  • Network Details Mode — Enables a mode where the panel is used to capture additional details related to network-based questions (e.g., relationships or connections).
  • Network Question — Allows you to select a network question from the survey to link panel entries with network data. Appears only when at least one network question exists in the survey.
  • Panel Display Mode — Defines how panels are presented to users:
    • List — Displays all panels one below another on the same page.
    • Panel navigator + Progress bar (top) — Shows one panel at a time with navigation controls and a progress bar at the top.
    • Panel navigator + Progress bar (bottom) — Navigation controls and progress bar are displayed at the bottom.
    • Panel navigator + Progress bar (top and bottom) — Navigation controls and progress indicators are shown at both the top and bottom.
    • Tabs — Displays each panel as a tab.
  • Initial Panel Count — Specifies how many panels are displayed when the survey first loads.
  • Minimum Panel Count — Sets the minimum number of panels that must remain.
  • Maximum Panel Count — Limits the maximum number of panels that can be added.
  • Inner Panel Expand State — Controls how panels are expanded or collapsed by default:
    • Users cannot expand or collapse panels.
    • All panels are collapsed.
    • All panels are expanded.
    • First panel is expanded.
  • Allow Adding Panels — Enables users to add new panels dynamically.
  • Allow Removing Panels — Allows users to delete existing panels.
  • Add Panel Button Text — Customises the label for the button used to add panels.
  • Remove Panel Button Text — Defines the label for the button used to remove panels.
  • Title Template — Defines a dynamic title for each panel using expressions or variables.
  • Description Template — Sets a dynamic description for panels based on entered data.
  • Empty Entries Text — Displays a message when no panels are available.
  • Confirm Panel Deletion — Prompts users to confirm before deleting a panel.
  • Confirmation Message — Defines the message shown when confirming panel deletion.
  • Previous Panel Button Tooltip — Sets the tooltip text for navigating to the previous panel.
  • Next Panel Button Tooltip — Sets the tooltip text for navigating to the next panel.
  • Question Numbering — Controls how questions are numbered within panels:
    • Hide numbering.
    • Restart numbering in each panel.
    • Continue numbering across panels.

Validation

  • "Non-unique key value" Error Message — Defines the message displayed when duplicate values are entered in fields that require unique entries.
  • Key Column — Specifies which column is used as a unique identifier for each row, ensuring values in that column are unique across all rows.

HTML​

General

  • HTML Markup — Adds formatted content to the survey, such as instructions, headings, links, or custom text blocks. This content is displayed to respondents but does not collect responses.

Expression (read-only)​

General

  • Expression — Defines the formula used to calculate the value dynamically based on other answers or variables.
  • Currency — Specifies the currency used when displaying values in currency format.
  • Value Display Style — Controls how the calculated value is formatted:
    • None — Displays the raw value.
    • Decimal — Displays as a number with decimal formatting.
    • Currency — Displays as a monetary value.
    • Percent — Displays as a percentage.
    • Date — Displays as a date value.
  • Formatted String — Allows custom formatting of the displayed value using a defined format pattern.
  • Maximum Fractional Digits — Sets the maximum number of digits shown after the decimal point.
  • Minimum Fractional Digits — Defines the minimum number of digits shown after the decimal point.
  • Display Grouping Separators — Adds separators (e.g., commas) to improve readability of large numbers.

Data

  • Precision — Defines the number of decimal places used when displaying the calculated result. A positive number limits the decimal digits (e.g., 2 → 2 decimal places). A value of -1 means no restriction.

Image​

General

  • Image or Video URL — Specifies the source of the image or video. You can provide a direct URL or upload a file from your device.
  • Content Mode — Determines how the content is interpreted:
    • Auto — Detects content type automatically.
    • Image — Forces image display.
    • Video — Treats the source as a video.
    • YouTube — Embeds a YouTube video.
  • Image Fit — Controls how the image fits within its container:
    • None — Original size.
    • Contain — Scales to fit within the container.
    • Cover — Fills the container while maintaining aspect ratio.
    • Fill — Stretches to fill the container.
  • Image Height (in CSS-accepted values) — Sets the height of the image (e.g., auto, 200px, 50%).
  • Image Width (in CSS-accepted values) — Sets the width of the image (e.g., 100%, 300px).
  • Alt Text — Provides alternative text for accessibility and screen readers.

Signature​

General

  • Signature Width — Defines the width of the signature input area.
  • Signature Height — Defines the height of the signature input area.
  • Show the Clear Button — Displays a button that allows respondents to clear and redraw their signature.
  • Background Image — Sets an optional background image for the signature area (e.g., a guideline or template).
  • Pen Color — Specifies the colour used for drawing the signature.
  • Background Color — Defines the background colour of the signature area.
  • Image Format — Determines the format in which the signature is saved (e.g., PNG, JPEG, SVG).

Network Nomination​

Network Nomination questions do not have question-specific properties beyond those covered in Question Common Properties.