Using Variables in Content

Personalize your content with customizable text tags to boost engagement with your users.

Lauren Cumming avatar
Written by Lauren Cumming
Updated over a week ago

Variables offer a great way to personalize your content at scale by allowing you to make the most of the data that you send through to Candu. As with email marketing, in-app personalization is a great way to boost engagement with your users.

Whereas Candu's Segmentation features allow you to modify large buckets of content, variables allow you to dynamically change text tags within your content to create a relevant and personalized experience for all of your users.

Common use cases for variables include:

  • Adding a 'Welcome {first_name}' or 'Welcome {company_name}

  • Adding in metrics or statistics that relate to the product usage for that user or the company they belong to. For example 'Your FEATURE NAME score is {benchmark_score}.' or 'You have completed {Task_count} so far!' This is a great way to help users understand the value they are getting from your platform or possible areas they need to improve on.

Adding variables to your content

All variables can be based on the same data that you pass over to Candu to create Segments. This usually consists of user traits like name, email, role type, and company.

To create a variable, in the Candu editor simply highlight the text that you want to transform into a dynamic tag. Among the formatting options, you'll see the variable icon.

To create a variable, in the Candu editor simply highlight the text that you want to transform into a dynamic tag.

Click this, and a new menu will pop up. The first field is a dropdown that will list all the data attributes you're currently passing to Candu. The second field will be your fallback option for users that do not have that data field filled out.

Simply select the data you want to be dynamic and you will see the text change to {variable_name}.

You will see a variables drop down to select the relevant data point and a fallback option incase there is no data for a particular user

Variable Fallbacks

Variables work best if you consistently track and pass data for the field. You can still use variables if you do not have data for every user. For the users without data, you can setup a fallback for each variable.

By default, the fallback option will be the text you've highlighted to create the variable. If you delete the text, the fallback will be blank. Be careful not to put blank fallbacks at the end of sentences or before punctuation or your fallback users will only see floating punctuation.

Once you've added a variable to your content, it will dynamically render the proper trait--or the fallback--for each individual user that logs into your application.

To delete a variable, simply treat it as text and delete the text.

an example of variables on a training banner showing how to add a dynamic tag

Setting up Variables

If you are not yet passing any data into Candu, learn more about this process here. Our typical integrations use either code, or a third party integration like Segment.com to pass user traits information to Candu.

ℹ️ Additionally, if you are sending us personal information like name and email, we recommend setting up 'Signed Identities' to secure your users' privacy when using variables.

Did this answer your question?