> ## Documentation Index
> Fetch the complete documentation index at: https://help.journeyfront.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# Offer letter and document templates

> Upload the Word files your offer letters and supporting documents are built from.

> [!NOTE]
>
> **Who can do this:** Admins with *Company Settings Access* upload and manage templates. Users with the *Offer Packages* permission can see and preview templates while building a package, but can't upload or change them.

Templates are the reusable files your offers are built from. An **offer letter** template is the letter itself. A **document** template is anything that goes out with it, such as an NDA, an equipment agreement, an arbitration agreement or a benefits guide. You design them once in Microsoft Word, and Journeyfront personalizes them for every candidate with your logos, formatting and branding intact.

## Letters, documents and PDFs

| Kind | File type | Merge keys | Signed? | In an offer package |
| - | - | - | - | - |
| Offer letter | Word (.docx), under 5MB | Yes | Yes, when it has signature fields | One (a package that only sets default terms can have none) |
| Document (Word) | Word (.docx), under 5MB | Yes | Yes, when it has signature fields. Otherwise included for the candidate to read. | Any number, in the order you choose |
| Document (PDF) | PDF, under 5MB | No, attached as uploaded | No, included for the candidate to read | Any number |

A template with at least one signature field shows an **E-Signature** chip. One without shows **No signature** and goes out with the offer for the candidate to read.

## Create a template

**1. Design it in Word**

Build the letter or document in Microsoft Word, with your logo, headers, tables and styling.

**2. Add merge keys and signature fields**

Type merge keys in double curly braces where values should appear, such as `{{CANDIDATE_NAME}}`, `{{SALARY}}` or `{{HIRING_CLASS_START_DATE}}`. Add signature fields where people sign, such as `{{CANDIDATE_E_SIGNATURE}}`. Save the file as .docx.

**3. Open the right templates page**

Go to **Settings**, then **Offers**. Choose **Offer Letter Templates** for a letter, or **Document Templates** for a supporting document.

**4. Upload the file**

Click **Add Offer Letter Template** or **Upload Document** and choose the file. The **Template Name** fills in from the file name; edit it if you like.

**5. Check the detected fields**

Journeyfront lists the signature fields and merge keys it found in the file. Anything it doesn't recognize is called out, so you can fix a typo before the template is used.

**6. Save, then add it to a package**

Click **Save**. To use the template, add it to an [offer package](https://help.journeyfront.com/offers/offer-packages.md).

![The Upload Offer Template window after choosing a Word file, showing the template name, an E-Signature chip, the e-signature and offer keys it found, and an unrecognized SALERY key called out in red](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/offers/templates/gen-template-upload-modal.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=f43318926b5a98e270c5dd73b25c37dd)

> [!TIP]
>
> To find the right key, open the **Merge Fields** reference on the **Offer Letter Templates** page, search for the field and click its key to copy it. See [Offer fields and merge keys](https://help.journeyfront.com/offers/offer-fields.md) for the full list and how to add keys to your own fields.

Merge keys work in the body text and in tables. Keys in headers, footers and text boxes aren't detected or filled in, so keep them in the body of the document.

## Signature fields

Signature fields mark where each person signs when the offer is sent for [e-signature](https://help.journeyfront.com/offers/e-signatures.md). They aren't filled with a value; they become signing boxes.

| Field | What it places |
| - | - |
| `{{CANDIDATE_E_SIGNATURE}}` | The candidate's signature |
| `{{CANDIDATE_E_SIGNATURE_DATE}}` | The date the candidate signed |
| `{{CANDIDATE_E_SIGNATURE_INITIALS}}` | The candidate's initials |
| `{{COMPANY_E_SIGNATURE}}` | Your company signer's signature |
| `{{COMPANY_E_SIGNATURE_DATE}}` | The date your company signer signed |
| `{{COMPANY_E_SIGNATURE_INITIALS}}` | Your company signer's initials |

> [!TIP]
>
> If someone at your company should co-sign the offer, add `{{COMPANY_E_SIGNATURE}}` to the template. When no document in an offer has a company signature field, Journeyfront sends the offer for the candidate's signature only.

## Manage templates

Each row shows the template's name, its signature chip, **Used By** (the offer packages that include it; click to see them), and when and by whom it was last updated. Open the row menu to:

* **Preview** the rendered document in your browser. PDFs open in your browser's viewer. On the **Document Templates** page, the merge keys the file uses are listed under the preview, signature fields last. You see the same list when you preview a letter or document from the offer package editor or in Send Offers; the **Offer Letter Templates** page's own preview shows the letter without it.
* **Download** the file.
* **Edit** to rename the template or upload a new version. A new upload re-detects the fields.
* **Delete** the template. You can't delete a template that an offer package still includes.

![The preview window for the Hourly Offer Letter, as opened from an offer package, showing the letter with a company logo and the merge fields in this document listed beneath it in alphabetical order, with the e-signature keys last in green](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/offers/templates/gen-template-preview-modal.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=5bca5ba06edbd9a2daa095eb1833b13b)

## Generate a document outside an offer

You can create a personalized document for a candidate without sending an offer, for example to print and sign in person. In the **Documents** section on the Candidate Application's **Details** tab, click **Generate Document**, pick a document template, and Journeyfront fills it in for that candidate and saves it there. Nothing is sent for e-signature.

## FAQ

> [accordion] What file formats are supported?
>
> Offer letters must be Word (.docx) files. Documents can be Word files or PDFs. Every file must be under 5MB. PDFs are attached as uploaded and can't hold merge keys or signature fields.

> [accordion] What's the difference between an offer letter template and a document template?
>
> They're the same kind of file with the same fields. The difference is their role in an offer package: exactly one letter, and any number of documents. Upload each file on the page that matches its role.

> [accordion] Can a candidate sign a PDF?
>
> No. PDFs are included for the candidate to read. Anything that needs a signature must be a Word template with signature fields.

> [accordion] Why aren't my merge keys being detected?
>
> Check the format: two curly braces on each side, an upper-case key, and no spaces inside. Word sometimes splits a token internally when you edit part of it, so select the whole token, retype it and upload again. Keys in headers, footers or text boxes aren't detected; move them into the body text. The upload screen lists anything it didn't recognize.

> [accordion] Why can't I delete a template?
>
> An offer package still includes it. Click **Used By** to see which packages, point them at another template, then delete it.

> [accordion] What happens if a merge key has no value for a candidate?
>
> Your team sees the gap before anything is generated, and either fills in the value or chooses to leave it blank in the documents. See [Offer fields and merge keys](https://help.journeyfront.com/offers/offer-fields.md#when-a-value-is-missing).

> [accordion] Can I include images and logos?
>
> Yes. Images, logos, headers, footers, tables and all Word formatting are kept in the generated document.

## Related

> [card] [Offer fields and merge keys](https://help.journeyfront.com/offers/offer-fields.md)
>
> Every key you can use, and how to add your own.

> [card] [Offer packages](https://help.journeyfront.com/offers/offer-packages.md)
>
> Put your templates to work.

> [card] [E-signatures](https://help.journeyfront.com/offers/e-signatures.md)
>
> How the letter and documents are signed together.

> [card] [Offers overview](https://help.journeyfront.com/offers/overview.md)
>
> How all the offer pieces fit together.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.