Templates
The Templates hub is the single home for your organization’s reusable templates. It has two sections:
- Certificates — the title, body, and signatory printed on issued certificates.
- Email — overrides of the built-in notification emails (subject + HTML), per language.
Certificate templates previously lived under Courses → Certificates. They now live here. The old link redirects automatically.
Open the Templates hub
- In the sidebar, click Templates (admin section).
- Use the Certificates / Email tabs at the top to switch sections.
| Section | Permission required |
|---|---|
| Certificates | certificate:configure (Admin or Owner) |
template:manage (Admin or Owner) |
You only see the tabs you have permission for.
Insert variables with the glossary
Both certificate body text and email templates support variables — placeholders
written as {{token}} that are replaced with real values when the certificate is
issued or the email is sent.
To add one:
- Click your cursor where you want the value to appear.
- Click + Add variable above the field.
- Pick a variable from the list. It is inserted at the cursor as
{{token}}.
Each variable shows its name and a sample value. Unknown tokens (typos) are left as-is so you can spot them.
Certificate templates
Certificate templates define what appears on the issued PDF.
Configuration reference
| Field | Description |
|---|---|
| Template name | Internal name shown in the list |
| Certificate title | The large heading (e.g. “Certificate of Completion”) |
| Body text | The statement line. Supports variables (see below). Leave blank for the standard “has successfully completed” line |
| Signatory name | Printed centre-bottom |
| Signatory title | Printed under the signatory name |
| Default | One template per tenant is the default, used by any course/path that doesn’t pick its own |
Certificate variables
| Variable | Inserts |
|---|---|
{{learnerName}} | The learner’s full name |
{{courseTitle}} | The course or learning-path title |
{{completionDate}} | The date the certificate was issued |
{{certificateNumber}} | The unique certificate number |
A course or learning path picks its template (or the default) in its own editor.
Email templates
Each notification type ships with a built-in, bilingual email. You can override any of them with your own subject and HTML — per language — without touching the built-ins.
How overrides work
- Pick a notification type from the list, then edit the English and Français (CA) versions independently.
- When no override exists, the subject and HTML body are pre-filled with the
built-in template (in
{{variable}}form), so you start from what learners actually receive and tweak from there. - An override applies only when Use this override is checked. Uncheck it to keep your draft saved but fall back to the built-in template.
- Reset to default removes the override entirely and puts the built-in template’s content back into the fields; the built-in email resumes.
- A type with any saved override shows a custom badge in the list.
Live preview
A Preview panel at the bottom of the editor renders, as you type, the email that will actually be sent for the selected type and language, using sample values for every variable:
- With Use this override checked, it shows your custom subject and HTML.
- With it unchecked, it shows the built-in email.
Both are shown exactly as your learners receive them: inside your organization’s email frame (see below), with your own logo and button colour.
Three notification types — Quiz passed, Assignment due soon, and Assignment overdue — have no built-in email: by default learners only see an in-app notification. For these, the preview says so, and an email is sent only once you save and enable an override.
Links in the preview are inactive. The panel is a rendering of the email, not
a working inbox — the URLs in it are sample values, and following one would
replace the preview with a page that cannot be displayed. Clicking a link does
nothing; the styling is exactly what the recipient sees. To check where a link
points, read its href in the body HTML, or send yourself a real notification.
Your branding in every email
Every email your organization sends to its learners, instructors and managers (the built-in ones and your overrides alike) shares one frame:
- Your logo at the top (set under Settings → Branding). With no logo set, your organization’s name appears there instead.
- Your primary colour on the single action button. If that colour would make the button text hard to read, the text switches between white and near-black automatically, and a colour no text can be read on is darkened slightly, so every button stays readable (WCAG AA).
- Your organization’s name in the footer, under the “why you received this” line.
Your override supplies only the body: the frame adds the logo and footer
around it, so you do not need to repeat them. An override written as a complete
HTML page (with its own <html> or <body> tag) is sent exactly as written,
without the frame.
Configuration reference
| Field | Description |
|---|---|
| Subject | Plain-text subject line. Supports variables |
| HTML body | The email body, placed inside your email frame (logo on top, your name in the footer). Basic HTML is supported. Variable values are inserted HTML-escaped (safe) |
| Use this override | When unchecked, the built-in template is used instead |
Available variables
Variables differ by notification type (the + Add variable menu always shows the correct set). Common examples:
| Variable | Inserts |
|---|---|
{{recipientName}} / {{recipientFirstName}} | The recipient’s name |
{{courseName}} / {{courseUrl}} | Course title / link |
{{certNumber}} / {{credentialsUrl}} | Certificate number / link to the learner’s certificates |
{{sessionTitle}} / {{startAt}} / {{joinUrl}} | ILT/VILT session details |
Troubleshooting
| Problem | Cause / fix |
|---|---|
A variable shows literally (e.g. {{coursename}}) in the sent email | The token is misspelled or not available for that type. Use the + Add variable menu, which only lists valid tokens. |
| My override isn’t being sent | Confirm Use this override is checked, and that you saved the correct language. The recipient’s language decides which version is used. |
| The Email tab is missing | Email templates require the template:manage permission, which the Admin and Owner roles hold. A custom role needs it too. |
| The email shows my organization’s name instead of my logo | No logo is set, or it is not a web (https) address. Upload one under Settings → Branding. |
| My button colour looks slightly darker in emails | Your primary colour is in the narrow range where neither white nor dark text is readable, so it is darkened just enough for white text. Pick a lighter or darker primary to have it used exactly. |
| Clicking a link in the preview does nothing | Expected — preview links are inactive on purpose. Send yourself a real notification to test a link. |
| Certificate body text doesn’t appear on the PDF | Body text only renders when set; otherwise the standard line is used. Re-open the template and save the body. |