Certificate templates¶

A certificate template defines the layout and content of the PDF certificates your learners receive after completing a course or learning path. This page shows how to create a template and how to assign it to a course or learning path.

How the interplay works¶

Kurs / Lernpfad  →  Zertifikatsvorlage zugewiesen?
                         ↓ ja                    ↓ nein
              Bei Abschluss wird          Kein Zertifikat
              automatisch ein PDF
              generiert + Lernende
              bekommen Benachrichtigung

A template can be assigned to several courses or learning paths. So if you want the same layout for many courses, you build one template and point to it from all courses.

Viewing existing templates¶

In the app under Administration → Templates — certificate templates are those of type certificate.
A list of all existing templates in your company.
Clicking a template opens the preview and editing options.

Screenshot to follow

Certificate-templates overview with preview cards

It pays to use or duplicate existing templates instead of building a new one each time — your company often already has a standard template with logo and corporate design that you can use as a basis.

Creating a new template¶

Click New template.
Fill in the fields:
Name — e.g. "Standard certificate 2026"
Template type — certificate (for certificates; other types would be email or assignment-reminder)
Certificate title — what appears large on the certificate (e.g. "Successfully completed")
Choose the layout:
portrait / landscape
background image from the media library (optional, often the company branding)
position for the logo, the company's main logo
select fonts
Write the content with placeholders — see the next section.
Generate a preview PDF with sample data — check how it looks.
Save.

Available placeholders¶

In the template's text fields you can use placeholders that are replaced with real data when the certificate is generated:

Placeholder	What is inserted
`{{ user_name }}`	Full name of the learning person
`{{ course_name }}`	Name of the course (or learning path)
`{{ completion_date }}`	Date of completion
`{{ issued_date }}`	Issue date
`{{ score }}` / `{{ score_percent }}`	Score achieved in percent (if the course contained graded quizzes)
`{{ company_name }}`	Name of the company providing the course
`{{ company_logo }}`	Company logo (inserted as an image)
`{{ verification_code }}`	Unique code for online verification
`{{ verification_url }}`	Full URL to the verification page
`{{ qr_code }}`	QR code for verification (inserted as an image)

Placeholders work in the heading, main text, footer and in embedded tables. The notation is snake_case (with underscores). Image placeholders like {{ company_logo }} and {{ qr_code }} are automatically rendered as an image.

Example template text¶

                    Zertifikat
            Erfolgreich abgeschlossen

      {{ user_name }}
      hat den Kurs

      «{{ course_name }}»

      am {{ completion_date }} mit einer
      Punktzahl von {{ score }}% bestanden.


      ___________________________
      {{ company_name }}

      Verifizierung: {{ verification_code }}
      {{ qr_code }}

Validity and expiry¶

For some trainings (safety, compliance training) certificates are time-limited — e.g. one year.

Configurable in the template:

Valid indefinitely — no expiry date, the certificate stays official forever
Time-limited — a number of days / weeks / months / years after issue. The PDF then shows "Valid until [date]".

After expiry: - the verification URL reports "no longer valid" - learners can retake the course, then they get a fresh certificate

Assigning a template to a course¶

In the course settings (see Creating a course), go to the field Certificate template.
Select the desired one from the list of existing templates.
Save.

From now on, a certificate following this template is generated automatically at every course completion.

Assigning a template to a learning path¶

Learning paths have their own template assignment — analogous to a course.

In the learning-path editor, go to the field Certificate template.
Select a template.
Save.

Learning-path certificates are independent of individual course certificates. Learners who complete all courses of a learning path receive both sets (provided both templates are set).

Testing a template¶

Before the first productive use it pays to:

Open the template → Preview.
Generate a sample PDF with test data.
Visual check:
Are all placeholders correctly replaced?
Does the layout look right, no text running over the edge?
Background image + font color easy to read?
Logo placed appropriately?
If something isn't right: adjust, new preview, until it fits.

Frequently asked questions¶

My logo is rendered blurry. Store the logo in a higher resolution in the media library — as PNG or SVG. For very wide logos it can help to create a square variant.

The placeholder {{ studentName }} shows unreadable special characters. Possibly an encoding problem in the text. Choose a different font that reliably supports umlauts and special characters (e.g. Open Sans, Roboto).

A template should apply to many courses — how efficiently? Create one template and assign it to all relevant courses. Later changes to the template automatically apply to all courses that use it.

What happens to existing certificates when I change the template? Already issued certificates remain unchanged (the PDF is generated and stored). Only newly generated certificates use the changed template.

Can I have different templates for different languages? Yes — create different templates (e.g. "Standard DE" and "Standard EN") and assign the appropriate one per course. Automatic language selection per learner is currently not in the UI.

Can I create a certificate manually / issue one afterwards for someone who did the course offline? Currently not directly in the UI. Workaround: enroll the person in the course, mark all lessons as completed, then the certificate is generated automatically. Or use the template manually with Office tools.