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

  1. On the profile's Letters tab, click Create new letter.

  2. In the Create a letter window, choose the Letter template.

  3. 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.
  4. Tick Include application attachments (files embedded in PDF only) to add the files uploaded with the application to the end of the PDF.

  5. Fill in the template's Ask fields, if it has any.

  6. 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.