Platform Reference
Survey Programming Reference
AI-Enhanced Validation for Text Questions
The MX8 Labs platform checks responses to text questions in surveys using AI by default, guaranteeing that the input aligns with the expected format o...
Working with low incidence studies
The MX8 Research Platform uses simulated responses to test and validate the survey, and if you're working with a low incidence rate survey, then it's ...
Adding metadata to questions
It's widespread to have a survey where we want to ask similar questions about various tags. We might be asking about different TV shows, product featu...
Validating Complex Surveys on the MX8 Research Platform
When designing complex surveys, it is crucial to ensure their accuracy and functionality from the outset. To streamline this process, the MX8 Research...
Validating Complex Surveys
You may already know our article on adding custom validation to questions. When it comes to grid questions, validation offers more flexibility. Inst...
Formating your survey text with markdown
You can incorporate markdown into your survey questions and options text to provide formatting, such as headers, bold, and italicized content. You can...
Text Highlighter Question
The text highlighter question allows respondents to mark one or more sections of a passage by selecting and highlighting text. This question type is...
Creating Calculated Variables
Many studies utilize calculated variables, either for use within the survey or for analysis. In this example, we'll walk you through how to create var...
Using Advanced Python Features
ython’s standard library is packed with powerful modules that, when combined with MX8’s survey API, can deliver advanced logic, smarter routing, and...
Getting Help with Programming Market Research Surveys in Python Using ChatGPT
When programming market research surveys in Python, researchers without a background in coding can benefit from using AI tools like ChatGPT to trouble...
Survey Instruments
Show Message
You can use this to present important information or context that doesn't require a choice. It's ideal for: Welcome messages or intros Section headers...
Number Question
Use this when you need a numeric input within a defined range. It's best for: Age, year, count, or frequency questions Questions that require range-ba...
Text Question
Use this to collect open-ended responses where you want to capture thoughts, opinions, or unaided recall. It's ideal for: Brand recall Reasons behind ...
Consent Question
Use this to ask for explicit consent before continuing with a survey. This is typically placed at the very start of the survey to meet legal or ethica...
Select Question
Use this when you need a single-select multiple-choice question. It's suitable for: Categorical data collection (e.g. gender, preferences, ratings) Re...
Grid Rating Question
Use this to capture numeric or labeled ratings across multiple items in a structured format. It's useful for: Performance, satisfaction, or quality ra...
Multi Select Question
When and Why to Use Use this when the respondent can select more than one option. Ideal for: • Attitudes, experiences, or features that apply in paral...
Grid Select Question
Use this to collect structured responses across multiple attributes. Ideal for: Marking multiple items on the same scale (e.g. product attributes) Cap...
Multi Select Grid Question
When and Why to Use Use this to let users select multiple items from each row of a grid. Best for: • Capturing multiple associations across brands or ...
Numeric Grid Question
When and Why to Use Use this to capture numeric input across a grid of rows and columns. Best for: • Time allocation or quantity distribution • Budget...
This or That Question
Use this to ask binary forced-choice questions across multiple comparisons. It's ideal for: Preference testing between paired items Quick-fire brand o...
Show Embedded Content
Use this to embed third-party content—currently only YouTube videos—within your survey. This is ideal for: Testing reactions to public video content P...
Show Image
Use this to present an image for a limited amount of time. Best suited for: Passive exposure to stimuli before a follow-up question Advertising or con...
This or That Rating Question
Use this to gather nuanced preferences across paired options using a rating scale. Ideal for: Capturing degrees of preference between two alternatives...
Secure Video Player
Use this to present a video stimulus, optionally with a live dial for feedback. It's best for: Ad or creative testing Comprehension and recall studies...
Ranking Question
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 Fe...
MaxDiff Question
Use this to identify the most and least preferred items from a set. It's ideal for: Prioritizing features, messages, or concepts Understanding tradeof...
Net Promoter Score Question
When and Why to Use Use this to capture Net Promoter Score (NPS), which measures the likelihood of a respondent to recommend a product, service, or br...
Kid Picker Question
Use this when a study targets minors and you need a parent/guardian to: confirm how many children fall within an age window, record each child’s age a...
Location Question
The Location Question allows you to collect a respondent’s location based on their postal code (zipcode). It works in two steps: The respondent is a...
Get All Children Question
Use this when you need a complete roster of children within an age window, including: total count, each child’s age (with optional recodes), each chil...
Standard Screeners
Call standard_screener() when you need a ready-made demographic screener that — Adds the core demo questions (age, gender, region, etc.) in the right...
Rating Question
Use this to capture how strongly a respondent feels about a given item or concept on a numeric scale. Ideal for: Measuring attitudes or satisfaction C...
Data Exports
SPSS Export Format
The SPSS (.sav) format presents data in the same wide structure as the Wide format export (one row per respondent, one column per question) but al...
Wide Excel Format
The Wide format presents each respondent as a single row, with each survey question represented as a separate column. This format is particularly us...
Long Excel Format
The Long format is designed for detailed, question-by-question analysis. It includes all the data stored in the platform and is identical to the dat...
Survey Functions
Least Fill
Use this to dynamically select a subset of items that have the fewest responses (i.e. are underrepresented) in a given quota. Ideal for: Ensuring even...
Verifying Phone Numbers
When and Why to Use Use this to verify the respondent’s identity by phone. This adds a layer of security and is ideal for: • High-sensitivity or confi...
Terminating Respondents
Use these to disqualify respondents based on logic at any point in the survey. terminate_if() allows you to specify a condition to check inline termi...
Calling external APIs
Use this to make outbound HTTP requests to approved external APIs during a survey. This is useful for: Personalizing content based on real-time data V...
Quotas
Use these together to enforce quota sampling in your survey. This helps control the composition of your sample by limiting how many respondents fall i...
Calculated variables
When and Why to Use Use these to save and retrieve values for use in survey logic or reporting. • store_value() lets you assign a value (like a derive...
Metadata Tagging
The tag() function lets you attach metadata to survey questions. Tags make it easier to group, filter, and analyse responses later by associating cont...
Media Functions
The media collection provides access to images and videos uploaded via the MX8 dashboard. These media items can be used in questions, filtered dynamic...
API Reference
In the MX8 platform, surveys are written in Python using the Survey class. Surveys should always start with the code block: from survey import Surveys...
Public API for Reporting and Agentic Analysis
The MX8 Labs Research Platform API gives developers and analysts programmatic access to survey data and reports. It’s read-only and designed for int...
Survey Programming Cookbook
Here are some ways to set up some of the more advanced features you might need to add to your survey. Recodes can be added to a survey using the recod...
