Conditional Logic

Conditional logic creates dynamic, personalized experiences that adapt based on user properties and survey responses. Use conditional logic to branch survey paths, trigger different actions, or show different content to different users.

Where you can use conditional logic

Conditional logic works with both guides and surveys. You can select it as an action for either primary or secondary buttons.

Types of conditions

Create conditions based on two types of data:

User properties

User properties are attributes about your users, such as location, subscription tier, or account type. User properties must be shared client-side during the session with either the Amplitude SDK or the Engagement SDK.

Common user property examples:

• subscription_tier
• country
• account_type
• initial_referring_domain

Survey responses

Survey responses are the answers users provide to questions in your surveys. Use survey responses to branch your survey based on how users answer.

Survey response examples:

• NPS ratings
• Star ratings
• Multiple choice selections
• Text input values

Combining conditions

Combine multiple conditions to create more advanced logic. When you add multiple conditions, all conditions must be met for the action to execute.

For example: if subscription_tier = premium AND country = US, then visit link to premium US-specific content.

Set up conditional logic

The setup process is similar whether you add conditional logic to buttons or to survey steps.

Add conditional logic to buttons

1. In your guide or survey, add a primary or secondary button.
2. Click the On button click dropdown.
3. Select Evaluate conditional logic.
4. Navigate to the Conditional Logic section.
5. Under When, select either User Property or Survey Response from the dropdown.
6. Configure your condition:
   • For User Property: Select the property, operator, and value.
   • For Survey Response: Select the question, operator, and value.
7. (Optional) Click Add condition to add more conditions.
8. Under Do this, select the action to execute when the condition is met.
9. Configure the action based on your selection.

Examples and use cases

Branch survey based on NPS score

Create a survey that asks different follow-up questions based on a user's NPS score:

1. Add an NPS rating block asking "How likely are you to recommend us?"
2. Add conditional logic:
   • If rating ≤ 6 (Detractors), then go to step asking "What can we improve?"
   • If rating ≥ 9 (Promoters), then go to step saying "Thank you! Would you leave us a review?"

Redirect users based on subscription tier

Create a guide with a button that directs users to different pages based on their subscription level:

1. Add a primary button labeled "View Features".
2. Select Evaluate conditional logic.
3. Add conditions:
   • If subscription_tier = premium, then visit link www.example.com/premium-features.
   • If subscription_tier = free, then visit link www.example.com/upgrade.

Show guide only to specific user segments

Launch a secondary guide based on both user property and survey response:

1. Add a primary button labeled "Next".
2. Select Evaluate conditional logic.
3. Add conditions:
   • If country = US AND rating > 8, then show guide "US-specific-offer".
   • If country ≠ US AND rating > 8, then show guide "international-offer".

Personalized CTA based on user properties

Create a button action that clicks different elements based on user characteristics:

1. Add a primary button labeled "Get Started".
2. Select Evaluate conditional logic.
3. Add conditions:
   • If user_type = new, then click element [data-testid="onboarding-flow"].
   • If user_type = returning, then click element [data-testid="dashboard"].

Best practices

• Test thoroughly: Use preview mode to test all conditional paths before publishing.
• Keep logic simple: Complex nested conditions can be difficult to maintain and debug.
• Monitor results: Use analytics to track how users flow through your conditional experiences.