Writing offer letters and contracts
Create the offer letter and contract templates your organisation sends and fill them with each candidate's details using merge fields.
Create the offer letter and contract templates your organisation sends and fill them with each candidate's details using merge fields.
Offer letters and contracts are written once as templates, then filled in with the candidate's details when you send an offer. This article covers writing those templates, the offer emails that carry them, and the merge fields available. For the Send Offer form, see "Making an offer". To change a document for one offer only, see "Reviewing and editing an offer's documents before you send it". What the candidate sees is in "What the candidate's offer page shows at each stage".
Who can do what
System Admin and HR users can open Settings > Offers > Offer Setup and see the Offer Documents tab. Only a System Admin can create, edit or delete a document. If an HR user tries to save, the save is refused. Other roles cannot open Offer Setup and are told they do not have permission to access it.
If your organisation is part of a group and a parent organisation shares its templates with you, those documents appear with a Shared from parent badge. You can choose them when sending an offer but you cannot edit or delete them.
Create a document
- Go to Settings > Offers > Offer Setup and open the Offer Documents tab. The left-hand list has two groups, Offer Letters and Contracts.
- Select Add offer letter or Add contract under the right group.
- Enter a Name (up to 255 characters). This is what recruiters pick from when sending an offer.
- Turn on Default document if you want the document marked as your standard one.
- Select Save. The document is created with starter text.
- Replace the starter text in the Content editor with your wording, then select Save again.
The editor supports bold, italic, underline, links, bulleted and numbered lists, text alignment, tables and text colour. The colour list offers Black, Blue, Green, Red and Purple, and the colour is kept in the offer PDF. Content cannot be empty.
The two document types are separate: an offer letter template can only be chosen in the offer letter field when sending, and a contract template only in the contract field. The Default document switch adds a Default badge in this list and "(Default)" beside the name in the Send Offer dialog. It does not pick the document for you. Recruiters still choose a template, or choose an offer type that has default documents set against it.
To remove a document, select it, then Delete, then confirm at Delete document?. This cannot be undone. Offers already sent keep their own saved copy of the text.
Offer emails
The offer itself reaches the candidate in an email, which you write on the Offer Emails tab of the same Offer Setup page. Select Add offer email, enter a Name, and choose a Category of Offer or Offer Accepted. Then write the Subject and Body, use Preview to check it, and select Save. The merge field row above the editor works as it does for documents.
An offer email must contain the Offer Link merge field. Send Offer stays greyed out until it does. The Offer Accepted email is the confirmation the candidate receives after they accept. "Using merge fields in email templates" and "Merge fields available for each template category" cover email merge fields in full.
Merge fields
A merge field is a tag in double curly brackets, such as . When the offer is sent, each tag is replaced with that candidate's details. Above the editor is a row of tags. Select one to copy it, then paste it into the document where you want it. A message confirms what was copied.
| Tag | Fills in |
|---|---|
| Candidate's full name | |
| First name | |
| Last name | |
| Title of the job | |
| Job location name | |
| Street address, city, county and postcode of the job's saved location. If the job has no saved location it uses the job's city, region and postcode. | |
| City the role is based in | |
| Region or county | |
| Postcode | |
| Country | |
| Workplace location, the free text employer site from the job | |
| Employment type, shown by its label such as Fixed Term | |
| Working pattern, shown by its label | |
| Your organisation's name | |
| Salary, formatted as a currency amount | |
| The pay period chosen on the offer: annual, monthly or hourly | |
| Signing bonus as entered, without a currency symbol | |
| Holiday days | |
| Hours per week | |
| Start date, for example 1 April 2026 | |
| Date the offer expires | |
| The date the offer is sent | |
| The candidate's link to view and respond to the offer |
gives only the name of the location, and is the free text site entered on the job. Use when you want the whole address in the document.
Any custom offer field you have added under the Offer Fields tab also works. Use its merge field key in double curly brackets. A custom field of the Date type prints in full, for example 5 April 2028, in letters, contracts and the signed PDF. works too, if the candidate has an address on record.
Job fields can be used as well. In Settings > Job Setup > Job Details Form, switch on Available in offer documents for a field and its value can be used in offer letters and contracts. Offer documents print each value the way the candidate would read it: dropdown and multi-select fields show their option labels, checkboxes show Yes or No, and dates print in full. Salary From and To print as currency amounts, and Currency, Period and Closing Date are available too. Leave the switch off for fields meant only for your own team.
If a value is not available, such as a bonus that was left blank, the tag is replaced with nothing. The tag is fixed at the moment you send, so the sent document always shows its real issue date.
Spell each tag exactly as listed. When you save, Recruit rejects a tag it does not recognise and names it, for example: content references , which is not a merge token supplied for offer documents. Correct the spelling and save again.