On this page

Personalize with Variables

The Personalize with variables feature (also called interpolation) dynamically displays user properties to customize content in a guide or survey. Use this feature to customize content for each user, such as displaying their first name or user_id. You can add personalized variables to:

  • Titles
  • Content
  • Button labels
  • Button Action URLs

Common examples

Replacing parts of a URL

Use user property variables in CTA links to personalize URLs. For example, create a link like:

plaintext
www.example.com/path?user_id=@{{property.user_id}}&country=@{{property.country}}

When a user clicks the CTA link, Amplitude replaces the user property variables with actual values:

plaintext
www.example.com/path?user_id=12345&country=US

Personalizing guides with a user's name

Create a user property that holds the user's first name, such as firstName. Place the firstName property in any guide or survey field where you want to address users by name.

Providing fallback values

A user property isn't always available for every user or every session. Use a fallback value to display a default when the property is missing. For example, to display "Hey there" instead of "Hey {firstName}" when a user hasn't provided their name, use a fallback like {{property.firstName | there}}.

User property requirements

Send user properties from the client during the active session, using either the Amplitude SDK or the Engagement SDK. Properties sent in prior sessions, and properties stored only on the server, aren't supported.

To set user properties, use the _setUserProperties method in the Engagement SDK, or amplitude.identify() in the Amplitude SDK.

Amplitude autopopulates user_id and device_id for you. These variables are always available without additional setup.

User properties in conditional logic

User properties can also power conditional logic. Use conditional logic to create different button actions or survey paths based on user characteristics. For example, direct premium users to different content than free users.

Add personalized variables to a guide or survey
  1. Open an existing guide or survey, or create a new one.
  2. Select the title, content block, button name, or other text field. The personalize variable icon appears on the right of the selected field.
  3. Select the user property icon.
  4. In the popup, enter the user property name.
  5. (Optional) Enter a fallback value for the user property.
  6. Select Insert.
  7. Repeat for every field where you want to add property variables.

Was this helpful?