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. You can place more than one survey block in a single step on all platforms, including mobile. For the highest completion rates on small screens, consider limiting each step to one block.

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. Conditions can reference responses from any prior step in the survey, not just the current one.

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.
Branch based on earlier responses: Reference answers from any previous step to create multi-layered survey paths. For example, use a rating from step 1 to determine what happens after step 3.
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 reference responses from earlier steps. For example, in a multi-step survey:

Step 1 asks for a feature rating.
Step 2 asks a follow-up question.
Step 3 uses conditional logic based on the step 1 rating: if step 1 rating < 3 then Go to a detailed feedback step, otherwise Go to a thank-you step.

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. Amplitude generates an AI summary of long-answer responses, shown on the Insights tab.

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.

For a full breakdown of which survey blocks work on which mobile form factors, go to Mobile Guides and Surveys.

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.

Dynamic data

A Dynamic data block attaches extra context to each survey response without displaying anything to the user. Respondents don't see or interact with it.

Each Dynamic data block captures one value per response:

A static value you enter in the builder, for example a campaign name or survey version.
An event property from the event that triggered the survey, for example document_uuid. This option requires an On event tracked trigger. Go to Setup and Targeting for details.

Use the captured value to join survey responses with your own data, or to segment results in analysis. Dynamic data values appear as columns in the Responses tab.

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?