Personalization Tokens allow you to customize your Action, making thank you emails & submissions personal to your targets and supporters and allowing you to capture other information about submissions.
Tokens allow your actions to personalize your messages without having to manually configure each message type. Now when a message is sent to a target, it can directly address the target and be signed with your supporters information without any extra steps on behalf of the supporter. This makes taking action easy without sacrificing personalization.
This can be applied to Thank You Emails. When a supporter receives a thank you message, they’ll be thanked by name. This helps to show your appreciation for your supporters, and gives them another chance to show their support.
All tokens are placeholder text surrounded by square brackets; however, the way that placeholder text looks is different for each token type. Below, we explain each token type you'll find on the Content tab, and a list of common tokens within each category.
This category of Token is ideal for customizing messages to targets. User Friendly Tokens explain what their function is within their brackets, making them ideal tokens to display to supporters.
For example, in an automatically generated email form, a supporter will see [your name will go here] in the signature line (salutation) for the email they’re sending.
|Action taker's full name||[your name will go here]|
|Action taker's location||[your email address will go here]|
|Recipient's full name||[recipient name will go here]|
|Recipient's first name||[recipient first name will go here]|
|Recipient's last name||[recipient last name will go here]|
|Recipient details||[recipient name and position will go here]|
|Recipient's position||[recipient position will go here]|
Tool Submission Tokens can be used to customize messages or collect custom data in components.
For example, this token: [submission:values:first_name] will capture the contents of the First Name component and display it in a message.
Any component that allows for text entry will have an associated Tool Submission token, meaning there are countless opportunities to customize your action!
|Submission First Name||[submission:values:first_name]||First name entered by the submitter of the form|
|Submission Last Name||[submission:values:last_name]||Last name entered by the submitter of the form|
|Submission Email||[submission:values:email_address]||Email Address entered by the submitter of the form|
|Submission Phone||[submission:values:phone_number]||Phone Number entered by the submitter of the form|
|Street Address||[submission:values:address:thoroughfare]||The street part of the address entered by the supporter|
|Submission City||[submission:values:address:locality]||City entered by the supporter|
|Submission Province||[submission:values:address:administrative_area]||Province entered by the supporter|
|Submission Postal Code/Zip||[submission:values:address:postal_code]||Postal or zip code entered by the supporter|
|Submission Country||[submission:values:address:country]||Country entered by the supporter|
|Submission Letter||[submission:values:your_letter]||Letter to target Submitted by user from the form|
|Email Subject||[submission:values:email_subject]||Email subject line used in the submission|
|Date completed||[submission:completed_date]||The date the webform was first completed (not drafted)|
|Date submitted||[submission:date]||The date the webform was first save as draft or completed.|
|We'll notify your representative||[submission:values:well_notify_your_representative:first]||The first name of each target|
|[submission:values:well_notify_your_representative:last]||The last name of each target|
|[submission:values:well_notify_your_representative:full_name]||The full name of each target|
|[submission:values:well_notify_your_representative:full]||The full name and position of each target|
The party to which the target belongs
|[submission:values:well_notify_your_representative:jurisdiction]||The jurisdiction of the target|
|[submission:values:well_notify_your_representative:position]||The target's official position title|
|[submission:values:well_notify_your_representative:government_level]||Federal, state, etc.|
This category includes tokens that will automatically generate data in the background for and by your user, like your organization name, a randomly selected email heading, or a progress bar showing how many supporters have already taken action.
For example, this token: [node:og-group-ref:title] will create a thank-you email sign-off using the name of your Organization.
|Randomized Email Subject||[node:nm-randomized-email-subject]||A random email subject selected from the available subjects on a tool|
|Randomized message||[node:nm-randomized-messages]||A random message selected from all available messages on a tool|
|Organization||[node:og-group-ref]||The name of your organization|
|Title||[node:title]||The title of the campaign tool|
|Webform Submission Total||[node:webform-submission-total]||The total number of submissions made to this tool|
|Webform Submission Progress Bar||[node:webform-submission-total-percent]||The total number of submissions as a % of a goal|
|Webform Submission Inflated Percentage||[node:webform-submission-total-percent-plus]||Amplifies a tool's submission total. Eg: [node:webform-submission-total-percent-plus:635:1000]|
|Webform Submission Inflated Total||[node:webform-submission-total-plus]||Amplifies a tool's submission total. Eg: [node:webform-submission-total-plus:1000]|
|Webform Submission Progress Bar||[node:webform-submission-total-progress]||A progress bar showing the total number of submissions as a % of a goal|
To find tokens, you can use the lists above, or locate the available tokens right on your action:
1. Navigate to the Content page of your Action
2. Scroll to the Target Content section. Each field (excluding email subject) will have a token selection menu. Select your chosen menu.
3. Select the token you’d like to use, then copy and paste your chosen token into the relevant field.
4. Thoroughly test your action to ensure your token works how you intended. After that, you’re done!
Last Updated: May 10, 2021