Create custom tokens for email and offer templates

Permissions: Site Admin, and Job Admin who can manage custom fields

Product tier: Available for all subscription tiers

When creating or editing custom fields, you have the option to create a token for each custom field. These tokens can be added to email or offer templates to pull in information specific to the job, candidate profile, or application information.

Create a custom token for email and offer templates

To create a custom token for an email and offer template, click the Configure icon Icon Configure  in the upper right corner, and then click Custom Options in the left-hand panel

Screenshot of custom options menu item

From the Custom Options page, navigate to the Company Custom Fields section.

Click either CandidatesJobs, or Offers depending on the type of custom field for which you intend to create a custom token.

Screenshot of company custom fields

If the field hasn't been created yet, use the following links to learn how to create the custom field: 

Note: Organizations with Advanced or Expert subscription tiers also can create custom tokens using custom application fields

On the subsequent page, click the field name for an existing field to modify it. If you want to add a new field instead, click Add Field.


On the Edit Custom Field page, check the box next to Create new email token (optional). Edit the token name if needed. 

Screenshot of email token field

When finished, click Save.

Note: A custom token associated with a non-private custom job field always will populate when used in an email, even if the recipient does not have permission to access the field in Greenhouse Recruiting. A custom token associated with a private custom job field will populate in an email only if the recipient has the appropriate permissions in Greenhouse Recruiting to view the private field.

Find out which fields are available in a template

Once you define a custom email token, it will display in the tokens section at the top of the email template. You can see a full list of available tokens in this box.


List of email templates that can use custom tokens

You can use custom tokens in any of the following email types:

Note: Custom offer tokens can be used only in offer templates and in email templates created in the My Templates section. Custom offer tokens cannot be used in email templates created in the Organization-Wide Templates section.