Build a Survey | Amplitude Guides and Surveys

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 enables 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.
Rating labels	Enter text labels that appear on the low and high ends of the scale.
Emoji	A two, three, or five point scale that displays emojis that you choose for each value.
NPS	A 0 - 10 point Net Promoter Score.

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

Setting	Description
Required	Enable to require the user to enter a rating.
Numbers	A five or ten point scale that displays numbers to the user.
Stars / Numbers / Emoji	Select the number of options available in the rating. Not applicable to NPS.

Conditional logic

Conditional logic enables you to create dynamic survey experiences based on user responses and user properties. On each step of a survey, you can add one or more conditions that trigger different actions based on how users answer or their characteristics.

Use conditional logic to:

Trigger actions based on responses: Change what happens next depending 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 sophisticated branching logic.

For example, if you have a question with a five point scale, you can 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

This logic asks a followup question to users who gave a 1-3, and shows a thank you message to users who gave a 4 or 5.

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 more information 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.

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

Setting	Description
Required	Enable to require the user to enter a rating.
ARIA label	Provide a label to help screen readers understand the input's purpose.

Short answer

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

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

Setting	Description
Required	Enable to require the user to enter a rating.
ARIA label	Provide a label to help screen readers understand the input's purpose.
Pre-fill key	Populate the input with a user property that you specify, using the ingested name of the property, 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.

List

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

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

Setting	Description
Required	Enable to require the user to enter a rating.
ARIA label	Provide a label to help screen readers understand the input's purpose.
Multiple choice	Enables users to select more than one option. Changes the block's form elements from radio buttons to checkboxes.
Randomize order	Randomizes the order in which items appear 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

Setup and targeting of surveys works the same as for guides. Follow those instructions for your survey.