This Article Solved My Issue

How Do I Create and Use Offer Letter Tokens in Recruiting?

Describes how administrators can use Offer Letter Tokens and how to create custom Offer Letter Tokens in Paycor Recruiting.

This article is for administrators.

 

Overview

Tokens can be added to offer letter templates to automate the customization of the offer letters you send out. 

You can easily copy and paste tokens from the Offer Letter Tokens list into your offer letter template and the system will automatically replace those tokens with the relevant information. 

We also provide a sample offer letter template with pre-built tokens in Paycor Recruiting that align to areas related to company, signer, candidate, job, and compensation.

Paycor Recruiting also allows the capability for administrators to create custom tokens for usage on your offer letter templates. 

Any tokens that you add will be added to the Offer Letter Token List at the bottom of the page that lists all tokens under Custom Tokens.


How Do I Create an Offer Letter Token? 

1. Log in and go to People > Hiring> Applicant Tracking. The Recruiting dashboard appears. 

2. At the top, click Admin > Approvals, and the Approvals screen appears. 

Shows the Approvals screen

3. On the left in Offer Letters, click Offer Letter Tokens. The Offer Letter Tokens screen appears. 

4. Click the Create a New Custom Token button. The Create a Custom Token popup appears. 

Shows the custom token popup

5. Complete the fields and click Save

  • Name: The name of the token inserted into your offer letter templates.
  • Summary: Provide a brief explanation of how the token should be used.
  • Default Text: 
    • This is the text that will be inserted into an offer letter wherever the token appears. 
    • This default text is easily editable when preparing an offer letter for a candidate.

After you create a new token, it appears at the bottom of your Token list.


How Do I Add A Custom Token to an Offer Letter? 

After you create an offer letter token, you can add this custom token to an offer letter template and upload it to Paycor Recruiting for using at the offer letter stage.
 

1. Log in and go to People > Hiring> Applicant Tracking. The Recruiting dashboard appears. 

2. At the top, click Admin > Approvals, and the Approvals screen appears. 

Shows the Approvals screen

3. On the left in Offer Letters, click Offer Letter Templates. The Offer Letter Templates screen appears. 

4. Select a template. In this screenshot, we're using the sample offer letter template and inserting the custom token, Background Checks:

  • Where you want to insert a custom token, use these brackets [ and ] to surround the title of the custom token. 
  • In this example, it's [Background Checks].

Note: Pre-built tokens use these symbols { and }.

Shows a sample template

5. When the template is uploaded, it is ready to use with an offer letter to a candidate. 

6. Following the offer approval and creating the offer letter, select your offer letter, including the custom offer letter token.

Shows create offer letter

7. Any custom offer letter tokens you use appear at the bottom of the offer letter form page under Additional Details.

Shows additional details

8. If the blue toggle  is on, this includes the custom offer token with the default text. 

  • When you click Preview in the offer letter document viewer, the custom offer token default text appears. 
  • In the screenshot below, both Background Check and Relocation custom offer tokens are turned on and appear on the offer.
  • The red box indicates specifically the custom Background Check token:

Shows the token in a letter


9. If you toggle a custom token off and it turns grey , it will no longer be included on that offer letter token. 

  • Example: Toggling off the Background Checks offer letter token but leaving on the Relocation custom offer letter token will remove all language of Background Checks but leave the Relocation text.

Shows additional details

10. When looking at the offer letter preview, you will also see it removed.

11. When choosing which custom offer letter tokens you want to use in an offer letter, while the default text is provided, you can update it to any wording.

Shows the additional details

12. When you’ve made any changes to the default text for that offer token, you can view how those changes will appear in the same place where the token was placed in your offer letter template.

Shows a token in the letter

10. When you finish editing any of the offer details, make sure all other areas of your offer letter form are completed and proceed with the next steps of sending the offer letter to the candidate.

Need Assistance?
If you have any questions on setting up custom offer letter tokens, contact Recruiting Support at recruitingsupport@paycor.com

Updated: May 29th, 2025 4068 views


Give feedback about this article
Give feedback about this article
Our articles update frequently. Please be aware of this before printing.
Back to Top ↑