Correspondence templates — milestone-typed, multilingual letter and email templates with merge tokens used by the correspondence composer

Last updated: July 12, 2026 by Steve

Correspondence Templates

Correspondence templates are the reusable letters and emails your office sends to requestors and third parties. Each template is tagged with a milestone type (acknowledgement, fee estimate, final response, and so on), holds per-language subject and body content, and carries merge tokens that are resolved against the live record whenever a coordinator sends or generates a communication. They are drawn on by the correspondence composer and by letter generation.

Correspondence templates list (screenshot placeholder — capture: the Correspondence templates settings screen, showing the list grouped by milestone type with Display name, Type, and Enabled columns)

Where to find it

Open the Settings hub and choose Correspondence templates, in the Collaboration group alongside Notification templates and Document templates.

Template types (milestones)

The type is the milestone the template belongs to. It controls where the template is offered in the app.

Type Typical use
Acknowledgement First reply confirming the request was received
Clarification Asking the requestor to narrow or clarify scope
Fee estimate Communicating an estimated fee
Extension notice Notifying the requestor of a time extension
Third-party notice The statutory notice to a consulted third party
Interim response A partial or interim release
Final response The final decision letter
Response-package cover The cover letter attached to an exported response package
General Any other correspondence not tied to a milestone

Template fields

Field What it controls
Display name The label shown in the composer's template picker
Description Optional internal note
Type The milestone taxonomy above
Enabled Only enabled templates appear in the picker
Sort order Position within the picker

Each template also stores one content row per enabled language — a subject line and an HTML body, with one language marked as the default fallback.

Multilingual content

Author subject and body text for each enabled system language. The composer renders the template in the recipient's language and falls back to the default language when a translation is missing.

Merge tokens

Tokens are placeholders filled in when the letter is composed or generated — for example the request number and dates, requestor or third-party details, and the organization name ({InstitutionName}) from the Organization setting. Choosing a specific party re-merges so party tokens reflect that recipient. Rich-formatting templates expose their HTML source for editing.

How it affects end-user behavior

  • In the composer — reached from a request's Requestor tab (Send correspondence) or a consultation's Correspondence tab (Send notice…) — a coordinator picks a template; it fills the subject and body with tokens resolved, ready to edit before sending.
  • Send notice… pre-selects the Third-party notice template for the chosen party.
  • The Generate letter action (Log correspondence) and the response package cover letter also render from these templates.
  • A PII firewall runs on token replacement, so a third-party notice never leaks the requestor's identity into a letter addressed to someone else.
  • Disabled templates are hidden from the picker.

Tips

  • Keep exactly one enabled template per milestone type you rely on, so the picker offers an unambiguous default.
  • Author every enabled language before turning a template on — recipients on a missing language fall back to the default.
  • Use Sort order to float your most-used templates to the top of the picker.