Skip to end of metadata
Go to start of metadata

In addition to the generation of Performance results, it is also possible to create certificate files for a whole course or individual course elements. Those files can be downloaded as PDF files via a link in the performance results section of the course and printed by the user. 

Using several configuration options, you can influence the design of the certificate and limit the view or the print.

A certificate is issued for a passed course or course element. Instructions on how to configure the passed-status can be found in the section Configure assessment.

A certificate is only visible if performance results have been configured for the course. Instructions on how to configure performance results for a course can be found in the section Performance results.

A supplementary video is available for this function.


Related topics

Offer certificates

To automatically generate a certificate and display it to the learner, proceed as follows:

  1. Open the course editor and navigate to the desired course element. To receive a certificate for the entire course, go to the top course node.
  2. In the selected element, switch to the tab Assessment.
  3. Enable the option Use certificates.

  4. Choose the desired certificate template from the selection list Template for certificates. Apart from the example template, you can also use individually created templates. The latter will appear at the top of the selection list. 
  5. If you activate the option Display certificates only for tutors, the PDF files of the certificates will only be accessible via the assessment tool. A simple user has no access to this area and can thus not view, print, or download their certificate.

Please note that the template, which was chosen in step 4, is used for all certificates that are newly acquired after the publication of this modification. However, users will also receive a new certificate if they improve on their original result. The template will not affect existing certificates. This also applies if you exchange the template. It will only be used for new certificates.

Use individual certificate templates

Individual course templates must be saved to the storage folder of the course and linked to the respective course element. First open the course and switch to the course editor. Then select the entry Storage folder from the editor tools menu. Choose one of the following options according to your certificate template:

  • One or more certificate files with any name:
  1. First, create a new folder in the course storage folder with the exact title certificate_templates.
  2. Second, copy all HTML templates as well as images and CSS files referenced in these templates to the folder certificate_templates.
  3. Third, close the storage folder.


    Use the following example template file to test the function:

    Upload this file to the storage folder in the course editor and unzip it. Take a look at the examples included in the folder certificate_templates and edit them if necessary. The certificate templates will then be available under Use certificates in the Assessment tab of the course or course element.

  • A single template with the specified file name certificatetemplate.html (all letters in lowercase):
  1. Upload the HTML file with the specified file name to the course storage folder or the assigned resource folder of the course.
  2. All images and CSS files referenced in the template must also be copied to the course storage folder / resource folder as well.
  3. Close the storage folder.

When configuring the course element in the tab Assessment, select exactly this template from the list Template for certificates.


When preparing the certificate template, you can use different placeholders in the HTML file depending on the configuration of the learning platform. In the certificate of the respective user, the placeholders will then be filled with the corresponding data of the course or user.

Such a certificate template can, for example, directly be created and designed in the course storage folder using the built-in HTML editor. If you have created and uploaded a certificate template with an external editor, the system will warn against possible loss of information when editing the template with the integrated editor.

Course element ID

For some of the placeholders, you will need the individual course element ID. The IDs can be found in the course editor of the respective course element in the tab Title and description in the form of a number combination in the bottom right corner (e.g. ID: 94862470524389). Just replace the number combination with the one in the table using: ### indicated signs (e.g.: %%MARK:94862470524457%%).

%%COURSE_TITLE%%Title of the course for which the certificate is issued
%%COURSENODE_TITLE%%Title of the course element for which the certificate is issued


Date on which the performance results were achieved. The formatting of the placeholder is based on the language selected by the user. It can be adjusted with the following options:

%%GRADE%%Display of grades as text
%%MARK%%Mark for the entire course
%%MARK:###%%Mark for the course element with the ID ### (the course must be assessable)
%%ROOT_NODE_SHORT_TITLE%%Short title from the course root node
%%ROOT_NODE_TITLE%%Title from the course root node

Course metadata: Duration of the module

%%METADATA:moduleects%%Course metadata: ECTS
%%METADATA:moduleexam%%Course metadata: Exams
%%METADATA:modulelevel%%Course metadata: Level
%%METADATA:modulelink%%Course metadata: Link to the module
%%METADATA:modulemethods%%Course metadata: Teaching and learning methods
%%METADATA:modulename%%Course metadata: Name of the module
%%METADATA:modulenumber%%Course metadata: Module number
%%METADATA:moduleresponsible%%Course metadata: Person responsible for further education
%%METADATA:moduleversion%%Course metadata: Version
%%METADATA:moduleworkloadpresence%%Course metadata: Attendance time
%%METADATA:moduleworkloadprivate%%Course metadata: Private study time
%%METADATA:moduleworkloadtotal%%Course metadata: Total workload
%%PASSED%%Displays "Bestanden" or "Passed" in the certificate, depending on the configured user language at the time of passing

Date of birth with the following options:

  • Display style for the date
  • Setting the language

    Standard: %%PROPERTY:birthDay%%
    LONG DE: %%PROPERTY:birthDay_LONG:LANG=de%%
    FULL DE: %%PROPERTY:birthDay_FULL:LANG=de%%
    LONG EN: %%PROPERTY:birthDay_LONG:LANG=en%%
    FULL EN: %%PROPERTY:birthDay_FULL:LANG=en%%
%%PROPERTY:email%%Email address
%%PROPERTY:firstName%%First name
%%PROPERTY:lastName%%Last name
%%PROPERTY:orgUnit%%Organisation unit
%%SALUTATION:LANG=de%%Salutation (German)
%%SALUTATION:LANG=en%%Salutation (English)
%%SCORE%%Score for the entire course
%%SCORE:###%%Score for the course element with the ID ### (the course must be assessable)
%%OUTCOME:[variable name]:###%%

Output value of an ONYX test

This placeholder can be used for all variables displayed in the area of a test course element in the "Test configuration" tab>"Output variables of this resource" such as MAXSCORE, PASS_SCORE, SCORE, PASS as well as for individual test and section variables of the type text or numerical.

Output variables of an ONYX test resource

If the certificate should contain output values from another course element, the course element ID must be specified in the placeholder. For example, this is the case if the certificate is created for a structure course element and output values are to be retrieved from a test course element. If the certificate is created directly for the test course element for which the user values should be displayed, the specification in the form of %%OUTCOME:[variable name]%% will be sufficient.


%%USERNAME%%First and last name of the person who obtains the certificate as proof of performance.
%%VALIDTO_DATE%%Expiration date of the certificate (system-dependent metadata)


    <div id="center">
        <!--  header-logo -->
        <div id="header">
            <div id="logo"></div>

        <!-- content-part-->
        <div id="content">
            <div>hat am</div>
            <div>den Kurs</div>
            <div>erfolgreich absolviert.</div>

        <!-- signature line -->
        <div id="signature">
            <h3>Dieses Zertifikat wurde automatisch von der Lernplattform erstellt.</h3>
        <div class="clearfloat"></div>

        <!-- footer-logo -->
        <div id="footer">

body {font-family: Verdana,Helvetica,Arial,sans-serif; margin: 0; padding: 0;}
h1 {color: #888; font-size: 4em; margin-bottom: 80px;}
h2 {font-size: 2em; padding-bottom: 0px; margin-top: 40px; margin-bottom: 40px;}
h3 {font-size: 1.6em;}
.floaterright {float: right;}
.clearfloat {clear: both;}
#center {margin: 0 auto; width: 900px;}
#header {height: 152px;background: url(certificate_header.png) no-repeat #eee; box-shadow: 0 4px 4px -2px #AAAAAA;}
#content {height: 900px; margin-top: 100px;}
#content div, #signature span {font-size: 1.6em;}
#content div, #content h1, #content h2, #content h3 {text-align: center;}
#signature {text-align: left; margin-left: 20px;}
#signature h3 {font-weight: normal; font-size: 1.3em; margin-bottom: 5px; margin-top: 5px;}
#signature span {font-size: 1em;}
#footer {margin-top: 35px; height: 50px; background: url(certificate_footer.png) no-repeat #eee;}