Troubleshooting the New LearnPress Certificate Update: Canvas vs. Image Rendering

You update the LearnPress Certificates add-on, open a certificate that worked last week, and something is off. The layout looks different, an element is gone, or a learner emails to say the download button does nothing. The course itself still runs, so the problem sits in the certificate layer.

Most of these reports trace back to one change. The recent Certificate V2.0 update moved certificates from a static image model to a canvas that is drawn in the browser. That shift fixes real limits in the old approach, and it also adds a new set of things to check when a LearnPress certificate not working ticket lands in your inbox.

This guide explains the difference between canvas rendering and image rendering, then works through the failure points that show up after the update and how to clear them. Where a cause has not been confirmed with the LearnPress engineering team, it is marked, so you do not chase the wrong fix.

Canvas rendering versus image rendering

Preview renders the certificate with sample data so you can test before it reaches learners.

The old certificate was an image. A background picture was stored, text was placed at fixed coordinates, and the result was served as a flat file. What the learner downloaded was close to what was stored on the server.

The new certificate is a canvas. The builder saves the design as structured data: a list of elements, each with a position, size, font or image source, and style. When a learner opens their certificate, that data is loaded onto a canvas element and drawn by JavaScript in their browser, with placeholder tokens replaced by their name, the course title, and the dates. A download or PDF is produced from that rendered canvas.

This is why the update helps and also why new issues appear. The design stays editable and light because it is data, not one image per learner. Rendering now depends on the browser running the certificate script, loading the right fonts and images, and finishing before an export is triggered. Any break in that chain shows up as a LearnPress certificate not working report.

A short comparison helps set expectations. Image rendering was predictable and needed nothing from the browser, but it was heavy to store, hard to edit, and broke on long names. Canvas rendering is light, fully editable, and consistent with what you design, and it asks more of the browser at view time. The trade is worth it for most sites, and the checks below cover the cases where the browser side needs help.

First checks when your LearnPress certificate is not working

Start with the quick, safe checks before touching code or the database.

• Confirm both plugins are current. Update LearnPress core and the LearnPress Certificates add-on so their versions belong to the same release cycle.
• Clear caches. Clear your page cache, any CDN cache, and the browser cache, then reload the certificate. A cached copy of an old script or stylesheet is a frequent cause.
• Test in a private window. This rules out browser extensions and stale local storage.
• Check one certificate at a time. Open the certificate in the builder, click Preview, and see whether it renders with sample data. If Preview is fine but the learner view is not, the problem is on the front end, not the template.
• Read the browser console. Open developer tools, reload the certificate, and note any red errors. A missing script or a blocked file points straight at the cause.

These five steps resolve a large share of reports. If the certificate still fails, move to the specific areas below.

Common LearnPress update issues with certificates

The LearnPress update issues that affect certificates tend to fall into a few groups. Knowing the group narrows the fix.

Script not loading

The canvas cannot draw if the certificate JavaScript does not load. This happens when a caching or optimization plugin combines or defers scripts in a way that breaks the load order, or when a security rule blocks the file. Check the console for a 404 or a blocked request on the add-on asset files. As a test, disable script concatenation and deferral for logged-in users and reload.

Fonts falling back

If a font used in the design is not available when the canvas draws, the text renders in a fallback face and spacing shifts. Stick to fonts the builder provides, and preview after any change to a theme or a font plugin.

Layout looks different after the update

A design built under an older version of the add-on may need to be opened and re-saved in the new builder so it is stored in the current format. Open the template, check each element in Preview, adjust anything that moved, and save. This is a manual step and is worth doing once per active template.

Add-on and core version mismatch

Running a new add-on against an old core, or the reverse, is a classic source of LearnPress update issues. Update both, then retest. If you use other LearnPress add-ons, update those too so the whole set is aligned, the same way you would when working through an exam add-on setup or the course builder update.

Not yet confirmed with the engineering team: the exact conditions that force a template re-save, and whether an automatic migration runs on update. Treat the re-save step as a safe precaution rather than a documented requirement until that is verified.

How to handle missing certificate elements

The Layers panel shows every element, including ones hidden behind the background.

Missing certificate elements usually means one of three things: the element is present but not visible, the element depends on data that is empty, or the element did not survive a format change.

• Check the Layers panel. An element sent behind the background, or set to low opacity, reads as missing. Bring it forward and raise opacity.
• Check the data source. Course-based elements such as Course Start Date or Max Students render blank when the course has no value for that field. Fill the course field, or remove the element.
• Check position. An element dragged past the canvas edge is still there but off the visible area. Select it in the Layers panel and move it back in.
• Re-add if needed. If an element genuinely did not carry over, add it again from the left panel, style it to match, and save.

After fixing missing certificate elements, confirm with Preview using a long name and a long course title, since a re-added element can overlap neighbors that were fine before.

Not yet confirmed with the engineering team: whether specific element types are more likely to drop during an update. The steps above are general recovery steps and do not assume a particular bug.

Fixing LearnPress certificate PDF download problems

A LearnPress certificate PDF download is generated from the rendered canvas. If the canvas has not finished drawing, or an image on it comes from another domain without the right headers, the export can fail or come out blank.

• Wait for full render. Ask the learner to let the certificate page load completely before clicking download. On slow connections the button can be pressed too early.
• Host images locally. Logos, seals, and signatures should live in your own media library, not on a third-party URL. A cross-origin image can taint the canvas and stop the export.
• Check console errors on export. A security error at the moment of download points to a cross-origin image or a blocked script.
• Try another browser. If the LearnPress certificate PDF download works in one browser and not another, an extension or a strict privacy setting is interfering.
• Test the image export. If the image download works but the PDF does not, the issue is in the PDF generation step, which is useful information for a support ticket.

Not yet confirmed with the engineering team: the exact PDF library behavior and any server-side size limits on export. If image export succeeds and PDF export fails consistently after these checks, raise it with LearnPress support with the console output attached.

WordPress LMS database optimization after the certificate update

The design is stored as data and drawn on a canvas, then exported to image or PDF.

One reason the canvas model is worth the migration effort is WordPress LMS database optimization. Under the old model, each certificate design was an image, and busy sites built up many of them. Under the new model, a design is stored as structured data and reused for every learner, so one template serves a whole course.

After the update, a short cleanup pass helps:

• Review the media library for old certificate background images that no template uses anymore, and remove the ones you have confirmed are unused.
• Consolidate templates. If you built several near-identical designs, merge them into one reusable template and point courses at it.
• Run a standard database cleanup with a maintenance plugin to clear transients and orphaned metadata, the same housekeeping covered in site speed optimization.
• Keep a backup before any bulk delete, so a mistaken removal can be reversed.

WordPress LMS database optimization is not a fix for a broken certificate, but it keeps the site lean as your catalog grows, and it removes clutter that can confuse future troubleshooting. Sites moving toward a managed setup can also look at LearnPress Cloud, where much of this housekeeping is handled for you.

What changed for learners after the update

It helps to know what a learner now sees so you can tell a real bug from expected behavior. The certificate page loads, the canvas draws the design with the learner details filled in, and a control lets them download the result. On a fast connection this looks instant. On a slow one there is a brief moment while the canvas paints.

Expected behavior includes a short render pause, fonts settling once they load, and the download producing a file that matches the on-screen design. Behavior that is not expected includes a blank canvas, an element that never appears, a download that does nothing, or a PDF that opens empty. The first group needs patience. The second group is what the checks in this guide address.

Course teams that track completion closely, for example alongside a question bank or exam time limits, should add a quick certificate check to their release routine so a learner is never the first to find a problem.

A repeatable troubleshooting order

When a LearnPress certificate not working report comes in, work in this order so you do not skip a cheap fix for an expensive one.

1. Update LearnPress core and the LearnPress Certificates add-on together.
2. Clear page, CDN, and browser caches, then reload.
3. Open the template in the builder and check Preview with sample data.
4. Reproduce the learner view in a private window and read the browser console.
5. If scripts fail to load, relax script optimization for logged-in users and retest.
6. Open and re-save any template built under an older add-on version.
7. Fix missing certificate elements through the Layers panel and the course data fields.
8. For a failing LearnPress certificate PDF download, host all images locally and confirm the canvas fully renders before export.
9. If image export works but PDF export does not, collect console output and open a support ticket.
10. Once resolved, run WordPress LMS database optimization to clear unused certificate images and transients.

Teams that document this order alongside their other course processes spend far less time on repeat tickets, and new team members can follow it without prior context.

When to contact LearnPress support

Contact support once you have run the repeatable order and the certificate still fails. A good ticket includes the LearnPress core version, the LearnPress Certificates add-on version, whether Preview works, whether the image export works while the PDF does not, the browser and version where it fails, and the console output from the failing page.

That detail turns a slow back-and-forth into a single reply. Vague reports lead to a request for exactly this information, which adds a day for no reason.

Get started

If a certificate is failing right now, run the first five checks in this guide before anything else. Update both plugins, clear every cache, test Preview, reproduce in a private window, and read the console. That sequence resolves most cases.

For anything that survives those checks, note whether image export works, whether Preview works, and what the console shows, then send that to LearnPress support. Keeping LearnPress core and the LearnPress Certificates add-on updated together is the single habit that prevents most certificate update issues in the first place.

Frequently Asked Questions

Read more: 10+ Best Corporate LMS: Top Platforms Compared