Adding custom fields to offers
Create your own text, dropdown and date fields for offers, set default values, and use them in offer letters and contracts.
Create your own text, dropdown and date fields for offers, set default values, and use them in offer letters and contracts.
This is for System Admin and HR users. Offer fields are extra details you want on your offers, such as a reporting manager, a work location or a probation end date. Recruiters fill them in when they send an offer, and you can place them in offer letters and contracts. They are managed at Settings > Offers > Offer Setup, on the Offer Fields tab.
Who can do what
System Admins and HR users can create, edit and reorder fields. Only a System Admin can delete a field: HR users do not get a delete button. Other roles do not see the page. Everyone who can send offers sees the fields in the Send Offer dialog.
Creating an offer field
- Open the Offer Fields tab and select Add Offer Field.
- Enter a Label (up to 255 characters). This is the name recruiters see.
- Enter a Merge field key, or leave it empty and one is created from the label. The key must start with a lowercase letter and use only lowercase letters, digits and underscores, up to 64 characters.
- Choose the Type: Text for free typing, Dropdown for a fixed list, or Date for a date picked from a calendar.
- For a dropdown, enter each choice under Options and use Add option for more rows. A dropdown needs at least one option.
- Optionally set a Default value (see below).
- Select Save.
The label, the dropdown options and the default value can be edited later. The key and the type cannot be changed after creation, so choose them carefully. If you need a different type, create a new field. Labels and keys must each be unique, otherwise you will see "An offer field with the same label or merge key already exists". Keys that offers already use for built-in details, such as the candidate's name or the salary, are refused with a message asking you to choose a different key.
Fields are always optional for recruiters. There is no setting to make one required, and dropdown fields include a None choice.
Default values
Each field has a Default value. The help text reads "New offers start with this value. Recruiters can change it before sending." Until you set one it shows No default.
- A text field takes free text.
- A date field gives a date picker.
- A dropdown default must be one of its options. If you rename or remove the option a default points at, the default is cleared and you choose again.
To remove a default, clear it and select Save. A default only affects offers opened afterwards. Offers already sent, or already in draft, keep what they hold.
Where fields appear
Every offer field appears under a Custom fields heading in the Send Offer dialog, in the order shown in your list. To change the order, use the Move up and Move down arrows beside each field.
To use a field in a document, type its key in double curly brackets in an offer letter or contract, for example . The key is shown under each field's label in the list. Custom fields are not in the merge-field palette of the document editor, so type or paste the key yourself. If you save a document containing a key that does not exist, the save is refused and the message names the key. When the offer is sent, the recruiter's answer replaces the key. If they left the field empty, that spot in the document is blank. A date field prints in full in offer letters, contracts and signed PDFs, for example "5 April 2028".
Deleting a field and what happens to existing offers
A System Admin can select Delete on a field and confirm. New offers no longer show it. Offers that already hold a value for the field keep that value.
- Offers keep the values entered for custom fields, along with the label and key those fields had at the time.
- Changing a field's dropdown options does not alter answers already saved.
For offer types and the other tabs of Offer Setup, see "Setting up offer types". Writing the documents that use these fields is covered in "Writing offer letters and contracts".