Letters
A letter is a document generated from a letter template for one profile: an offer letter, a contract, a certificate, a confirmation of enrolment. Every letter is kept on the profile's Letters tab as a PDF and, unless it needs a signature, a Word (DOCX) file.
The Letters Tab
The profile's Letters tab lists the profile's letters, newest first:
| Column | Contents |
|---|---|
| Name | The template's description |
| Created by | The staff member who generated the letter |
| Created at | When it was generated |
| Signature status | Not required, Signature pending, Signature pending with a count of signers who have signed, or Letter signed |
The tab appears on every profile except staff profiles and profiles that have been anonymised. Staff see it when their role has documents.letters_change.
Generating a Letter
-
On the profile's Letters tab, click Create new letter.
-
In the Create a letter window, choose the Letter template.
-
Choose what the letter is about, so that its merge fields have data to show:
Field Fills in Class The class, programme, journey, and the class's offers and payment plans Course The course, subject, and journey. Shown to staff with core.institutions.profile_courses_access.Application The application's fields, and the class or course it is for Payment Plan One payment plan to show. When left blank, the payment plans come from the class, course, or application chosen. -
Tick Include application attachments (files embedded in PDF only) to add the files uploaded with the application to the end of the PDF.
-
Fill in the template's Ask fields, if it has any.
-
Click Generate letter.
The letter appears on the tab when it is ready. Its files are named after the profile's full name and the template's description.
Note: If the application attachments cannot be added (for example, a file that cannot be read), the letter is still generated, without the attachments.
See Merge Fields for which fields each choice fills in.
Working with Letters
| Action | Detail |
|---|---|
| Download PDF | The letter as generated |
| Download DOCX | The Word version, to edit outside Full Fabric. Not offered for letters that require a signature. |
| Download PDF (signed) | Once a letter is signed, a second PDF download gives the signed copy from DocuSign |
| Request signature | Sends the letter for signing (see Digital Signatures) |
| Delete | Removes the letter. Needs core.institutions.profile_letters_delete. Asks Delete this letter? This cannot be undone. |
A letter cannot be edited or regenerated. To change it, delete it and generate a new one from the corrected template or data.
Warning: Deleting a letter that has a signature request does not cancel the request at DocuSign.
What the Profile Sees
Letters are not listed in the applicant portal. A profile receives a letter in one of two ways:
- By email — the automation Send letter action attaches the letter to an email
- By signing request — a letter sent for signature reaches the signer through DocuSign, or through a signing link staff copy and share
Sending Letters with Automation
The Send letter action generates letters and emails them to the profile. In a lifecycle workflow it is described as "Generates a letter from a template and shares it with the profile". It is also available in automation rules as Send letter to profile.
| Setting | Purpose |
|---|---|
| Letter templates | One or more templates. A letter is generated from each. |
| Email template | The email the letters are attached to, as PDFs |
| Dispatcher | Who the email is sent from |
| CC / BCC | Other recipients |
| Email subject | The subject line |
The letters are generated for what triggered the action: the application, or the class or course of the journey. Each one is also saved on the profile's Letters tab.
Note: Automation cannot fill in Ask fields, so letter templates with Ask fields generate letters with those fields empty.
See Automation for how rules and workflows are built.