LifterLMS Certificate Not Working? Fixing Awards, Blanks and Exports

Why LifterLMS certificates are not awarded, show blank names or stale details, or print and export badly, and how to fix each case: engagement triggers, duplicate checks, merge codes, syncing, print sizes, HTML downloads and PDF exports.

  • Add as a preferred source on Google
Illustration for “LifterLMS Certificate Not Working? Fixing Awards, Blanks and Exports”

Certificates matter more to students than almost anything else in a course, so when a LifterLMS certificate is not working the complaints arrive fast. A student finishes and nothing is awarded. The certificate appears but the name is blank. A corrected surname does not show up. The printout spills onto two pages, or the download fails.

This guide is for course owners and developers. It works through the three families of certificate problems: not awarded, wrong content, and bad output. For each one it explains what LifterLMS is doing behind the scenes, so you can fix the cause and not only the one student who complained.

If you have not built a certificate yet, read how to create certificates in LifterLMS first.

How LifterLMS awards a certificate

Understanding the chain makes every fix below obvious. Three pieces are involved:

  1. A certificate template, under Engagements > Certificates. This is the design, with merge codes such as {first_name}.
  2. An engagement, under Engagements. It connects a Triggering Event, such as "Student completes a course", to an Engagement Type of "Award a Certificate" and the template to use. It can be limited to one course, lesson, quiz or other item, and it can have an Engagement Delay in days.
  3. An awarded certificate, listed under Engagements > Awarded Certificates. When the trigger fires, LifterLMS copies the template, replaces the merge codes with the student's data, and saves the result as a separate record for that student.

That last step is the key to several problems: an awarded certificate is a snapshot, made at the moment it was awarded.

Certificate not awarded: check the engagement

Work through these in order, testing with a fresh test student each time.

1. Is everything published?

Both the engagement and the certificate template must be published. A draft engagement never fires, and LifterLMS refuses to award from a template that is not published.

2. Does the trigger match what the student did?

The available triggers include "Student completes a course", "Student completes a lesson", "Student passes a quiz", "Student completes a quiz", "Student completes a section", "Student completes a course track", and enrollment and purchase events. "Student completes a quiz" fires on any finished attempt, pass or fail. "Student passes a quiz" only fires on a pass. Choosing the wrong one is a common cause of certificates for students who failed, or none for students who passed.

3. Is the engagement pointed at the right item?

If you selected a specific course, lesson or quiz, the certificate is only awarded for that item. Leaving the selection blank applies it to all items of that type, which is rarely what you want for a course certificate. Check that the selected course is the one the student actually took, not an older copy.

4. Did the student actually complete it?

A course is complete when every lesson is complete. A lesson with a quiz that requires a pass, or a minimum time, does not complete until those requirements are met. Check the student's progress in LifterLMS > Reporting > Students. If a lesson is the blocker, see why a lesson is not marking complete.

5. Is there a delay?

With an Engagement Delay of one or more days, the award is scheduled through LifterLMS's background task system. If WordPress scheduled tasks are not running on your server, delayed certificates never arrive. Look under LifterLMS > Status > Scheduled Actions for pending or failed actions. A delayed award is also skipped if the student is no longer enrolled when it runs.

6. Was it already awarded?

LifterLMS checks for duplicates. If the student has already earned this template for the same related course, lesson or quiz, it does not award it again. That is usually helpful, but it surprises people who expect a new certificate each time a student retakes a course.

7. Did the student finish before the engagement existed?

Engagements only react to events that happen after they are published. Students who completed the course last month do not receive a certificate retroactively. Award those manually.

Awarding a certificate manually

For students who were missed, go to Engagements > Awarded Certificates and click Award Certificate. Choose the student and the template, then click Award. LifterLMS merges that student's details into the template, exactly as an automatic award would.

For more than a handful of students, a developer can script the award in bulk from the list of completers, which is quicker and avoids typing errors.

Blank names and wrong details: merge codes

These are the merge codes LifterLMS core supports on certificates:

Merge codeInserts
{first_name}, {last_name}The first and last name on the WordPress user profile
{student_name}The user's display name
{email_address}, {user_login}, {student_id}Email, username and user ID
{earned_date}, {current_date}The award date and the current date, in your site's date format
{certificate_id}, {sequential_id}The certificate's ID and its sequential number
{site_title}, {site_url}Site name and the student dashboard address

Typical causes of blank or wrong values:

  • The profile has no first or last name. If your registration or checkout form does not collect names, {first_name} is empty. Add name fields to your forms, as covered in LifterLMS registration and account forms, or use {student_name}.
  • A typo in the merge code. Codes must be typed exactly, braces included. Use the merge code button in the certificate editor to insert them.
  • Codes from another plugin. Merge codes from older guides or other LMS plugins are not replaced, and appear as literal text.

Name changed but the certificate did not: syncing

Because an awarded certificate is a snapshot, editing the template or a student's name afterwards does not change certificates already awarded. To refresh them, sync.

  • All certificates from one template: open the template and use the Sync Awarded certificates panel to update every certificate awarded from it.
  • One certificate: open it under Awarded Certificates and sync it with its template.

Syncing reapplies the current template and current merge data, so {current_date} will also update. Use {earned_date} for the date a certificate was earned so syncing never changes it.

Printing and exporting badly

An awarded certificate page offers Print and Download buttons, plus Enable sharing for a public link.

Printing

LifterLMS sets the printed page size and orientation from the template settings. If the certificate spills onto a second page or is cut off, check:

  • The template's size and orientation match the paper the student prints on. A Letter-sized certificate on A4 paper rarely fits.
  • Margins and background image dimensions fit inside the page.
  • In the browser's print dialog, scaling is set to default and background graphics are enabled, otherwise the background image disappears.

The core Download button

Core LifterLMS downloads a certificate as an HTML file, not a PDF. To build it, the server requests the certificate page from itself. That makes the download fail when the site cannot reach its own address, which happens behind HTTP basic authentication on staging, with some firewalls, or with a maintenance mode plugin. Fonts loaded from Google Fonts are also stripped from the export, so the downloaded file can look different from the screen.

PDF certificates

For real PDF files, LifterLMS sells the PDFs add-on. Its documentation explains that the PDF is drawn in the browser, and that images hosted on another domain, typically a CDN, can stop the export with a "Tainted canvases may not be exported" error. The fix is the add-on's image proxy, set up as described in the PDFs image proxy documentation.

Adding your own merge code

A frequent request is the course name on a generic certificate template. Core does not have a course title merge code, but a developer can add one with two filters: llms_certificate_available_merge_codes lists it in the editor, and llms_certificate_merge_data supplies the value when the certificate is awarded or synced.

<?php
/**
 * Plugin Name: LLMSX Course Title Merge Code
 */

add_filter( 'llms_certificate_available_merge_codes', 'llmsx_add_course_code' );
function llmsx_add_course_code( $codes ) {
	$codes['{llmsx_course_title}'] = __( 'Course Title', 'llmsx' );
	return $codes;
}

add_filter( 'llms_certificate_merge_data', 'llmsx_course_code_data', 10, 4 );
function llmsx_course_code_data( $codes, $user_id, $template_id, $related_id ) {
	$title   = '';
	$related = $related_id ? llms_get_post( $related_id ) : false;

	if ( $related instanceof LLMS_Course ) {
		$title = $related->get( 'title' );
	} elseif ( $related && method_exists( $related, 'get_course' ) && $related->get_course() ) {
		$title = $related->get_course()->get( 'title' );
	}

	$codes['{llmsx_course_title}'] = $title;
	return $codes;
}

The value is only filled in when the certificate is awarded or synced, so sync existing certificates after adding a new code.

Frequently asked questions

Why did a student who failed the quiz get a certificate?

The engagement probably uses "Student completes a quiz", which fires on any finished attempt. Change it to "Student passes a quiz".

Can LifterLMS create PDF certificates without an add-on?

Core offers printing, which students can save as PDF through their browser's print dialog, and an HTML download. Downloadable PDF files come from the paid PDFs add-on.

How do I reissue a certificate with a corrected name?

Correct the name on the user profile, then sync that awarded certificate with its template.

Why are students not getting a new certificate when they retake a course?

LifterLMS does not award the same template twice for the same related item. That is intentional duplicate protection.

Next steps

Create a test student, complete the course as that student, and watch the chain: completion, engagement, awarded certificate, print. Wherever it breaks, the section above tells you why.

For recertification rules, certificates that need credits or verification pages, or bulk reissuing for hundreds of students, our LifterLMS customization service builds and tests it on staging first. Tell us how your certificates should work.

Add LifterLMS Expert to your preferred sources

Add lifterlmsexpert.com as a preferred source on Google, or open this article in your AI assistant to use it as a source.

  • Add as a preferred source on Google
Free consultation

Prefer expert help over DIY?

Skip the trial and error. Get specialist LifterLMS help and ship faster.

Talk to a LifterLMS Expert Explore our services

Replies within one business day