Skip to main content
Who can do this: Admins with Company Settings Access.
Offer fields are the terms of an offer: salary, start date, employment type, pay frequency, bonus, hiring manager and anything else your offers need. Merge keys are the keys, like {{SALARY}} or {{CANDIDATE_NAME}}, that place values into your offer letters and documents. Every offer field has a merge key, and so do the candidate, job req, hiring class and company details Journeyfront already knows, so your documents fill themselves in.

Offer fields

Offer fields appear on the offer form your team completes when sending an offer, and they’re what an offer package can pre-fill and lock. They apply to every job req in your account. Go to Settings, then Offers, then Offer Fields.
The Offer Fields page in Settings, listing the default offer fields and a custom Sign-On Bonus field with their types, merge keys and required status, with the + Field button highlighted

Default fields

Every account starts with these offer fields: Job Title fills in from the job req (its external job title, if it has one) and Today’s Date from the day the offer is created, unless a package or recruiter sets them. In Send Offer, the Offer Expiration Date also becomes the default expiry for the e-signature request. On a default field you can change the description and whether it’s required. Its label, type and options are fixed, and it can’t be deleted.

Add an offer field

1

Click + Field

It’s at the top right of the Offer Fields page.
2

Describe the field

Enter the Label your team sees (for example “Sign-On Bonus”), an optional Description, and the Field Type. For Multiple Choice, add the options.
3

Set the merge key

In Merge Key, type the key that goes between the braces, for example SIGN_ON_BONUS. In your templates it becomes {{SIGN_ON_BONUS}}.
4

Choose whether it's required

Turn on Required if recruiters must enter it on every offer, then click Save.

Field types

Edit, reorder or delete a field

  • Click the edit icon on a row to change the label, description, required setting or options. The merge key can’t be changed once saved, because your templates may already use it.
  • Drag the grip handle on the left of a row to reorder fields. Recruiters see fields in this order when they send an offer.
  • Click the delete icon to remove a field you added. Default fields can’t be deleted.
If a value is the same for everyone in a hiring class, such as the pay rate or schedule, don’t make recruiters type it on every offer. Set it as a default on the class’s offer package instead.

Merge keys

A merge key is a key in double curly braces that you type into a Word template, like {{CANDIDATE_FIRST_NAME}}. When Journeyfront generates the document for a candidate, it replaces each key with the real value from that Candidate Application. The values that went into each document are saved with it, so you always have a record of exactly what the candidate received.

Built-in keys

These work in any template with no setup: Your offer fields, and any personal or application fields you’ve given a key, use the key you chose.

Give a personal or application field a merge key

Personal and application fields only need a key if you want them in a document. For example, you can put the candidate’s preferred shift or their answer to a consent question straight into the offer letter.
1

Open the field

Go to Settings, then Custom Fields, then Personal Fields or Application Fields. Add a field with + Field, or edit one that doesn’t have a key yet.
2

Enter the merge key

In Merge Key, type the key between the braces. When you add a field, Journeyfront suggests one from the label, so “Preferred shift” becomes PREFERRED_SHIFT.
3

Save

The key now appears in the merge key reference and works in any template.
Merge keys follow the same rules everywhere:
  • Upper-case letters, numbers and single underscores only.
  • Unique across your account.
  • Fixed once saved. You can change the field’s label any time.
The Add Personal Fields window with the Label Preferred shift and the Merge Key input highlighted, showing PREFERRED_SHIFT between double curly braces with the format hint underneath

Find the right key

Go to Settings, then Offers, then Offer Letter Templates, and open the Merge Fields reference. Keys are grouped by where their value comes from: Candidate, Job, Company, Hiring Class, Date, E-Signature, Offer Fields, and any custom fields you’ve given a key, such as Personal Fields and Application Fields. Search for a field and click its key to copy it, then paste it into your Word document.
The Offer Letter Templates page in Settings with the Merge Fields reference, its search box and merge keys grouped by Candidate, Job, Company, Hiring Class, Date, E-Signature, Offer Fields and Personal Fields, with HIRING_CLASS_START_DATE just copied to the clipboard

How values appear in documents

When a value is missing

Before any document is generated, Journeyfront shows every key the documents use and the value each candidate will get. Missing values are flagged. In Send Offer, candidate details such as phone, address and custom fields can be fixed right there and are saved to the Candidate Profile. Anything still missing has to be filled in, or you choose to leave it blank in the documents. Nothing is generated with a gap you didn’t see. See Send an offer.

FAQ

The label is what your team sees on forms, for example “Sign-On Bonus”. The merge key is the token you type into documents, for example {{SIGN_ON_BONUS}}. You can change a label any time; a key is fixed once saved. Personal and application fields also have an internal name, which is a free-text identifier and doesn’t need to follow the key format.
No. Your templates may already use it, and changing it would break them. If you need a different key, create a new field.
Candidate name, phone and address are built-in merge keys now, filled from the Candidate Profile. Recruiters don’t type them on the offer form anymore. Use keys like {{CANDIDATE_NAME}} and {{CANDIDATE_ADDRESS_LINE_1}} in your templates.
Yes. Give the application field a merge key, then add {{YOUR_KEY}} to the template. The candidate’s answer for that Candidate Application is merged in.
Existing templates only use the keys typed into them. Add the new key to your Word file and re-upload it. The template’s Used By column shows which offer packages to check afterward.
On an offer package. A package can pre-fill any offer field and lock it so recruiters can’t change it.
No. Add as many as your offers need, and keep the required ones to what recruiters really have to enter.

Offer letter and document templates

Put merge keys and signature fields into your Word files.

Offer packages

Set default values and lock them.

Custom fields

Personal and application fields, and where they appear.

Offers overview

How all the offer pieces fit together.