Certificates
Learners earn a certificate when they complete a course or a learning path. This guide covers managing certificate templates and configuring which courses and paths issue a certificate.
Prerequisites
| Task | Who can do it |
|---|---|
| Manage certificate templates | Admin or Owner (the certificate:configure permission) |
| Turn certificates on or off for a course, pick its template | Any role holding course:update, including an Instructor on an assigned course |
| Issue or re-issue a certificate by hand | Admin or Owner, or an Instructor on an assigned course (certificate:issue) |
| Revoke a certificate | Admin or Owner (certificate:revoke) |
Manage certificate templates
A template defines what appears on the certificate — the title, body text, and signatory. The default template is used by any course that doesn’t pick its own.
- Select Templates in the admin sidebar. The Certificates tab opens first.
(The old
/admin/certificatesaddress, and the Certificate templates links in the course and learning-path editors, redirect here.) - Click + New template and fill in:
| Field | Description |
|---|---|
| Template name | Internal name shown in pickers (e.g. “Standard completion”) |
| Certificate title | Heading on the certificate (default: Certificate of Completion) |
| Body text | Optional supporting line — see Body text and variables |
| Signatory name / title | Optional signature block |
- Click Create template. The first template you create becomes the default automatically.
- Click Preview at any time — including before saving — to open a sample PDF with your current wording, your logo, and your brand colour.
To change the default, click Set default on any other template. Exactly one template is the default at a time.
Delete is offered only on templates with no issued certificates (issued certificates must keep their template for the record).
Body text and variables
Body text is the sentence printed under the learner’s name. Click + Add variable above the field and pick a variable from the list to drop in its placeholder at the cursor; it is replaced with the real value when the certificate is generated.
| Variable | Shown in the list as | Becomes |
|---|---|---|
{{learnerName}} | Learner full name | The learner’s full name |
{{courseTitle}} | Course / path title | The course or learning-path title |
{{completionDate}} | Completion date | The certificate’s issue date (for a certificate issued automatically, the day the learner completed), written out in the language of the course version the learner took (e.g. July 2, 2026) |
{{certificateNumber}} | Certificate number | The unique certificate number |
The same date is printed in the certificate’s footer. Single braces ({learnerName})
work too, so a hand-typed placeholder is never printed literally.
Two things adapt to what you write:
- If you leave the body text blank, the certificate uses the standard wording — “This certifies that” → name → “has successfully completed” → course title.
- If you write a full sentence (e.g. “Awarded to {{learnerName}} for completing {{courseTitle}}.”), it replaces that standard wording. The stock lead-in is dropped, and if your sentence already names the course, the separate course heading is dropped as well — so nothing is printed twice.
Long names, titles and sentences shrink and wrap automatically to fit the page.
Branding on the certificate
Certificates follow the organization branding set in Settings → Branding — no extra configuration:
| Branding setting | Effect on the certificate |
|---|---|
| Logo (Identity tab) | Printed at the top left, on a white plate inside the header band |
| Primary colour (Theme tab) | Header band, left edge, certificate title, and course title |
| No branding uploaded | Falls back to the EmbayLMS wordmark and navy |
Notes:
- The logo must be a PNG or JPG file. SVG and ICO logos cannot be embedded in a PDF — if your logo is one of those, upload a PNG version for certificates to use it.
- The teal accent (the rule under the title and the underline beneath the learner’s name) is a fixed EmbayLMS design signal and is not themed per organization.
Configure certificates on a course
- Open the course and go to the Settings tab. On a published course, click Start new version first — the settings panels are editable only on a draft.
- In the Certificate panel:
- Toggle Issue a certificate on completion on or off (it is on for a new course).
- Choose a Template, or leave it on Tenant default.
Changes save immediately. A learner who completes the course (all required modules) then receives the certificate, listed on their Achievements page under the Certificates tab.
| Setting | Effect |
|---|---|
| Issue a certificate on completion = off | No certificate is issued for this course |
| Template = Tenant default | Uses the organization’s default template |
| Template = a specific template | Uses that template for this course |
Issue a certificate by hand
Completions that never went through the completion engine — records imported from a previous LMS, enrollments an admin marked complete — have no certificate. Issue one from either place an enrollment is listed:
- The course’s Enrollments tab: on a row whose status is Completed and that has no certificate, click Issue certificate.
- The learner’s profile under Users, in its enrollments list: same button on the completed row.
- Click Issue certificate.
- Leave the Certificate template on Course default (or the tenant default), or pick another template for this learner only.
- Confirm. The certificate number appears on the row, the PDF is generated on demand through the normal download, and the learner is notified; the certificate appears on their Achievements page right away.
Re-issue. When a certificate was revoked, the row offers Re-issue certificate instead. The revoked certificate stays on record (its number is what the old PDF prints and what the verification page reports as revoked); the new one gets a new number. A row with a valid certificate offers nothing — there is one valid certificate per enrollment.
Revoke. Open the learner’s profile under Users and choose View or revoke certificates (shown to roles that hold certificate:revoke). Their Achievements page opens on the Certificates tab in admin view: click Revoke, enter a reason and confirm. A revoked certificate cannot be un-revoked; the verification page shows it as revoked, with the revocation date. To give the learner a valid certificate again, re-issue it (above). See Certificate verification & revocation.
| Rule | Behaviour |
|---|---|
| Permission | certificate:issue. Instructors can issue only on their assigned courses. |
| Enrollment state | Must be Completed. An active enrollment is refused. |
| Course setting | If Issue a certificate on completion is off for the course, manual issuance is refused too — turn it on first. |
| Audit | Every manual issuance is logged as issued (or reissued, with the replaced number), marked manual, with the template chosen. |
Configure certificates on a learning path
- Open the learning-path editor (Learning Paths → edit a path).
- Tick Issue a certificate when the path is completed and choose a Template (or leave it on Tenant default).
- Save.
A path certificate is issued automatically when the learner completes every required course on the path. It appears on their Achievements page with a Learning path badge and is downloadable as a PDF, just like course certificates.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| No certificate after completion | Certificates disabled on the course | Turn on Issue a certificate on completion in the course’s Settings tab |
| No certificate, toggle is on | No template exists yet | Create a template under Templates (the first one becomes the default) |
| Can’t delete a template | Certificates were issued with it | Templates with issued certificates are retained |
| Certificate shows the EmbayLMS wordmark, not our logo | No logo uploaded, or it is an SVG/ICO | Upload a PNG or JPG logo in Settings → Branding → Identity |
A variable prints as {{learnerName}} | The name is misspelled | Insert it with + Add variable — only the four variables above are replaced |
| The course title appears twice | Your body text already names the course | Nothing to do — the duplicate heading is dropped automatically |
Need help? Contact your EmbayLMS onboarding team or open a support ticket.