Tokens are small placeholders (see examples below) that you'll use on a tool's Content page to automatically enter user information and other campaign details into your tool form fields.
This means that you can have any information supporters enter or generate on a campaign tool automatically appear on the content generated by the tool, like emails and thank you pages.
A quick example: if you put the token [submission:values:first_name] in your letter to a target as a signature, it will be replaced by the supporter's first name.
Important: Tokens will only work if you have the given field available on your form!
Here is a list of commonly used tokens related to supporters and targets:
Name |
Token |
Description |
|
Tokens Related to Tool Submission Data (the content your supporters generate can be automatically added to emails and pages created by the campaign tool) |
|
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 |
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 |
Email Subject |
[submission:values:email_subject] |
Email subject line used in the submission |
Jurisdiction |
[submission:values:well_notify_your_representative:jurisdiction] |
The jurisdiction of the target |
Party |
[submission:values:well_notify_your_representative:party] |
The party to which the target belongs |
Position |
[submission:values:well_notify_your_representative:position] |
The target's official position title |
Country |
[submission:values:well_notify_your_representative:country] |
Target's country |
Government Level |
[submission:values:well_notify_your_representative:government_level] |
Federal, state, etc. |
|
Tokens Related to Tool Content (the content you create can be automatically added to emails and pages generated by the campaign tool) |
|
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 |
|
User Friendly Tokens (These tokens are formatted like little signposts. Supporters can see them and understand their function) |
|
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] |
|