Personalization Tokens

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.

Using Tokens 

Token Types

Finding Tokens

Using Tokens

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.

  

Token Types

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.

User-Friendly Tokens

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.

Name Token
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

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!

Name

Token

Description

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
 

[submission:values:well_notify_your_representative:party]

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:country] Target's country
  [submission:values:well_notify_your_representative:government_level] Federal, state, etc.

Tool Content

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.

Name Token Description
An organization's default policy for a specific tool type [node:nm-org-privacy-policy:?] Your privacy policy (set up when you create 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

 

 

 

Finding Tokens

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