Skip to main content
All CollectionsCustomization
Uploading a Custom Certificate
Uploading a Custom Certificate

If you want to upload your own HTML certificate of completion instead of using the default one, this article explains the entire process.

Stephen Krzeminski avatar
Written by Stephen Krzeminski
Updated over a week ago

Click on the Settings button on the right. Click System Configuration, then on the Certificate Template tab. Upload a custom certificate by clicking Add a New Template.

You can upload your own customized certificate by inputting your HTML code or use the default code provided.

If you click Documentation at the top right, you will see a list of placeholders.

These placeholders can be inserted in the code and will be automatically filled out when the certificate is generated. For example, if you place [NAME] as text in your code, a learner's first and last name will be generated in place of the placeholder.

Some elements on the certificate are static, and some parts are variables.
The variables that get stamped based on the Course Settings include:

  • [COURSE_NAME]

  • [CREDITS]

  • [NICE_COMPLETION_DATE]

  • [VALIDITY_LENGTH]

  • [NICE_EXPIRATION_DATE]

    Other variables get automatically pulled from the user's profile. These include:

  • [NAME]

  • [TITLE]

  • [COMPANY]

  • [USER_IDENTIFIER]

  • [PHONE_NUMBER]

You can always create additional user fields by making use of the Custom Labels feature.

To use fields in the Custom Labels feature, take the Default Value and replace the parenthesis with square brackets, capitalize all letters, and replace spaces with underscores.

For example, (Date of birth) will become [DATE_OF_BIRTH].

Users on a Professional or Enterprise plan also get access to custom course placeholders which can be set on a per-course basis. To start using them, go to the Course you want to add custom placeholders for and go to its General Settings tab.

Click Edit Custom Values to open the customization panel that contains both the placeholder value and the text field to set what they should say.

In summary, a certificate in our platform is an HTML page that automatically gets stamped with the users information, as well as information from the course.


Legacy Instructions

Click on Home on the left. Click Customization, then on the Certificate Template tab. Upload a custom certificate by clicking Add a New Template.

You can upload your own customized certificate by inputting your HTML code.

If you click Documentation at the top right, you will see a list of placeholders.

These placeholders can be inserted in the code and will be automatically filled out when the certificate is generated. For example, if you place [NAME] as text in your code, a learner's first and last name will be generated in place of the placeholder.

Some elements on the certificate are static, and some parts are variables.
The variables that get stamped based on the Course Settings include:

  • [COURSE_NAME]

  • [CREDITS]

  • [NICE_COMPLETION_DATE]

  • [VALIDITY_LENGTH]

  • [NICE_EXPIRATION_DATE]


Other variables get automatically pulled from the user's profile. These include:

  • [NAME]

  • [TITLE]

  • [COMPANY]

  • [USER_IDENTIFIER]

  • [PHONE_NUMBER]

You can always create additional user fields by making use of the Custom Labels feature.

To use fields in the Custom Labels feature, take the Default Value and replace the parenthesis with square brackets, capitalize all letters, and replace spaces with underscores.

For example, (Date of birth) will become [DATE_OF_BIRTH].

If you wish to resize the certificate, you can use the Zoom Factor and the Margins areas at the bottom of the page.

Zoom Factor resizes the image with a base size of 1. For example, if you entered 0.5, the certificate would be half the normal size.

Here is a Certificate with a Zoom Factor of 1.

And here is one with a Zoom Factor of 0.5.

The Margins field lets you specify the distance between the edge of the page and the closest edge of the certificate. The field is based on pixels in top, right, bottom, left order. To use this field, you enter numbers based on how many pixels you want to shift the certificate, and in which direction. For example, if you want to shift the certificate down, you need to add extra margin space at the top, so you could enter 50 0 0 0 to add 50 pixels worth of margins at the top, which moves the entire certificate 50 pixels down. You can also combine directions, such as moving down and to the right, where you would enter 50 0 0 100.

Here is an example with no margins set.

One with margins set at 50 0 0 0.

And one at 50 0 0 100.

In summary, a certificate in our platform is an HTML page that automatically gets stamped with the users information, as well as information from the course.

Did this answer your question?