LifterLMS Cron Problems: Fix Late Emails, Renewals and Engagements
Which LifterLMS jobs depend on WP-Cron and the Action Scheduler, how to tell whether your scheduler is broken, and how to replace unreliable WP-Cron…
Read articleWhy 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.
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.
Understanding the chain makes every fix below obvious. Three pieces are involved:
{first_name}.That last step is the key to several problems: an awarded certificate is a snapshot, made at the moment it was awarded.
Work through these in order, testing with a fresh test student each time.
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.
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.
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.
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.
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.
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.
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.
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.
These are the merge codes LifterLMS core supports on certificates:
| Merge code | Inserts |
|---|---|
{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:
{first_name} is empty. Add name fields to your forms, as covered in LifterLMS registration and account forms, or use {student_name}.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.
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.
An awarded certificate page offers Print and Download buttons, plus Enable sharing for a public link.
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:
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.
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.
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.
The engagement probably uses "Student completes a quiz", which fires on any finished attempt. Change it to "Student passes a quiz".
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.
Correct the name on the user profile, then sync that awarded certificate with its template.
LifterLMS does not award the same template twice for the same related item. That is intentional duplicate protection.
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.
Which LifterLMS jobs depend on WP-Cron and the Action Scheduler, how to tell whether your scheduler is broken, and how to replace unreliable WP-Cron…
Read article
A troubleshooting guide for LifterLMS quizzes that will not start, lose answers, time out, run out of attempts or grade in surprising ways, with the…
Read article
Which PHP version LifterLMS needs, which one you should actually run, and a step-by-step way to upgrade PHP on a course site without breaking…
Read articleSkip the trial and error. Get specialist LifterLMS help and ship faster.