Build a Survey

The survey build experience contains many of the same features at the guide builder, and uses a subset of the available form factors (modal, popover, pin) and properties.

Survey blocks

Surveys offer four unique block types, each suitable for capturing a different kind of user feedback.

Rating

The Rating block lets users provide structured feedback using a scale you define. Surveys provide the following rating types:

Rating type	Description
Stars	A three or five point scale that displays star icons to the user.
Numbers	A three, five, seven, or ten point scale that displays numbers to the user.
Emojis	A two, three, or five point scale that displays emojis that you choose for each value.
NPS	A 0 - 10 point Net Promoter Score.

Select the gear icon in the rating block to access more settings.

Setting	Description
Required	Enable to require the user to enter a rating.
Rating labels	Enter text labels that appear on the low and high ends of the scale.
Stars / Numbers / Emojis	Select the number of options available in the rating. Not applicable to NPS.

Conditional logic

Conditional logic lets you create dynamic survey experiences based on user responses and user properties. On each survey step, add one or more conditions that trigger different actions based on user answers or user characteristics.

Use conditional logic to:

Trigger actions based on responses: Change what happens next based on how a user answers.
Branch survey paths: Users who give a low rating might get a follow-up question asking why, while high ratings advance to a different step.
Personalized experiences: Show different questions or steps based on previous responses or user properties.
Combine conditions: Use both survey responses and user properties together to create branching logic.

For example, on a question with a five point scale, use the following logic:

If rating < 4 then Go to step to ask what went wrong
If rating > 3 then Go to step with a 'thank you' message

You can also combine survey responses with user properties. For example:

If rating > 8 AND subscription_tier = premium then Show survey asking for app store review
If rating < 5 AND country = US then Show survey with US support contact information

For details about conditional logic, including how to use it with buttons and guides, go to Conditional Logic.

Long answer

The Long answer block provides users space to provide unstructured feedback.

Select the gear icon in the Long answer block to access more settings.

Setting	Description
Required	Enable to require the user to enter a rating.

Short answer

The Short answer block provides users space to provide unstructured feedback.

Select the gear icon in the Short answer block to access more settings.

Setting	Description
Required	Enable to require the user to enter a rating.
Pre-fill key	Populate the input with a user property that you specify, using the ingested property name, for example `device_type`. If the user property isn't found for a specific user, nothing populates in the field. User properties must be available client-side during the current session. Go to Set user properties for implementation details.

Mobile pin limitations

Short answer and long answer blocks aren't available for mobile pins.

List

Lists provide a multiple choice input, letting users choose a response from a list that you define.

Select the gear icon in the List block to access more settings.

Setting	Description
Required	Enable to require the user to select an option.
Display as dropdown	Lets users select one option. Changes the block's form elements from radio buttons to a dropdown.
Multi-select	Lets users select more than one option. Changes the block's form elements from radio buttons to checkboxes.
Randomize order	Randomizes the item order in the list each time it displays to a user.
"Other" option	Provides users the option to select `Other` as a result, and optionally supply a written answer.

Setup and target your survey

Survey setup and targeting works the same as for guides. Follow the guide instructions to set up your survey.

Was this helpful?