Overview
Custom Tokens are used to personalize your outreach to candidates. They are variables that you can insert anywhere into your Sequence Stages , Campaigns , or Application Review to help customize them. We pull these variables from the Candidate Info and Your Custom Tokens fields within a candidate’s profile in Gem.
For example, rather than saying “Hi there!” at the beginning of every message, you could say “Hi {{first_name}}!” instead. As long as the candidate has their first name field filled out within Gem, the message they will receive will be personalized with their name (ex. “Hi Bob!”).
How it works
Sequences
All of your available Custom Tokens for Sequences overview can be found in your Sequence Stage editing window, right on top of the Subject line field.
Sequence Tokens can be inserted anywhere into the Subject or Body of your Sequence Stages. Simply use your mouse cursor to select where you would like the Sequence Token to be placed, then click on the Sequence Token to insert it.
Campaigns
For teams with access to our Campaigns: Create branded emails module, all of your available Custom TokenCampaigns: Create branded emails can be found in your Campaign editing window by selecting any Header or Text tool and clicking the “Custom tokens” dropdown.
Application Review
All of your available Custom Tokens for Application Review can be found in the customization tab of Team Settings.
Tokens can be inserted anywhere into the Subject or Body of your message. Simply use your mouse cursor to select where you would like the token to be placed, then click on the token to insert it. We recommend referencing the job and your company name in each message so the message is clear to the recipient.
Available Tokens
Basic Tokens
Token | Sequences | Campaigns | Application Review |
First Name | ✓ | ✓ | ✓ |
Last Name | ✓ | ✓ | ✓ |
Nickname | ✓ | ✓ | |
School | ✓ | ||
Company | ✓ | ✓ | |
Title | ✓ | ||
Your Company | ✓ | ||
Job | ✓ |
Advanced Tokens
Token | Sequences | Campaigns | Application Review |
Your Custom Fields (Reason and Extra tokens) | ✓ | ||
✓ | ✓ |
Things to note:
- The Reason and Extra tokens are not shared across team members. This means what you write into these fields within the Gem sidebar will not be visible or usable by any your colleagues. These fields are unique to your own Gem account and can only be used by you.
- If you decide to use a particular token andthe candidate does not have that information field filled out on their Gem profile, they will see a blank space in their message. For example, if you said, “I noticed that you’ve worked at {{company}} in the past.” and their Company field is empty, the candidate will receive: “I noticed that you’ve worked at in the past.” (Note the blank space between “at” and “in” since Gem didn’t have a Company name to insert.) To prevent this and account for scenarios where a profile field is blank, we suggest using Token Fallbacks. More information on how to set this up Blank candidate token fallbacks.
- When editing/previewing, your Custom Tokens will populate with the candidate’s information or your Custom Field Tokens, with exception to the Day of Week token, where the day will be inserted during the message sending process. More information on this Day of week token not populating.
Previewing Your Message
Curious to see how your message will look like to candidates? Click Send me a preview in your Sequence edit window or your Campaign edit window and Gem will send a copy of it to your inbox.
Have any issues or questions on this topic? Please feel free to contact your dedicated Gem Customer Success Manager directly or our Support team at support@gem.com.