LMS & eLearning

SCORM, xAPI and cmi5 on a WordPress LMS: What Works

What SCORM, xAPI and cmi5 are, how packages from Storyline, Rise or Captivate are played on a WordPress LMS, how completion and scores are tracked, and the hosting problems to avoid.

SCORM, xAPI and cmi5 on a WordPress LMS: What Works

WordPress LMS plugins do not play SCORM packages on their own. Upload a zip exported from Articulate Storyline or Adobe Captivate to the media library and nothing happens, because nothing on the site knows how to launch it or listen to it. A working SCORM WordPress LMS setup needs an extra layer that plays the package and translates what it reports into course progress.

That layer exists, and it works well when set up with the standards in mind. Here is what each standard expects, how the pieces fit on WordPress, and where sites usually trip: storage, caching and cross-domain hosting.

Three standards with one job

All three exist so that content built in an authoring tool can report to a learning platform it has never seen before. They differ in how the content and the platform talk.

SCORM

A SCORM package is a zip file with an imsmanifest.xml at its root that lists the content and where it starts. When the content opens in the browser, it searches its parent windows for a JavaScript object supplied by the LMS. In SCORM 1.2 that object is named API, and in SCORM 2004 it is API_1484_11. The content then calls it to say "initialized", "the learner is on slide 14", "status passed, score 85", "finished". The SCORM run-time reference lists the calls. Everything happens inside one browser session, in a frame the LMS controls.

xAPI

xAPI, once called Tin Can, drops the frame. Content sends statements in the form actor, verb, object ("Priya completed Fire Safety Module 2") over HTTP to a Learning Record Store, or LRS. The content can live anywhere and can be an app or a simulator as easily as a slide deck. The price is that you need an LRS, and something that turns a "completed" statement into a ticked lesson.

cmi5

cmi5 is a set of rules on top of xAPI for content that is launched from an LMS. It defines the package (with a cmi5.xml course structure), how the LMS launches each unit and passes it credentials, and a fixed vocabulary of verbs such as completed, passed and failed. It gives xAPI the plug-and-play behavior SCORM had.

What a SCORM WordPress LMS setup is made of

Three parts are involved:

  • The LMS plugin (LearnDash, LifterLMS, Tutor LMS and others), which owns courses, lessons, enrollment and progress.
  • A SCORM or xAPI add-on, which unpacks the uploaded zip, shows the content in a player on the lesson page, provides the API object the content looks for, and stores what it reports.
  • An LRS, only when you use xAPI or cmi5, or when the add-on works by converting SCORM data into xAPI statements.

LearnDash's own documentation is plain that content built inside LearnDash is not SCORM content and that playing SCORM or xAPI packages takes a third-party add-on. Its SCORM and xAPI page names GrassBlade xAPI Companion and Uncanny Owl's Tin Canny. Other LMS plugins have equivalents, and we maintain one ourselves, SCORM Bridge for LifterLMS.

When you compare add-ons, ignore the logos of authoring tools on the sales page and ask which standards and versions are supported: SCORM 1.2, SCORM 2004 and which edition, xAPI, cmi5. "Supports xAPI" does not mean it imports a cmi5 package.

How completion and score reach the course

The package only knows its own state. In SCORM 1.2 that is one field, cmi.core.lesson_status, plus a score in cmi.core.score.raw. SCORM 2004 separates completion (cmi.completion_status) from success (cmi.success_status). The add-on has to map those values to something the LMS understands, and this mapping is where to spend your testing time:

  • What marks the lesson complete? "Completed", "passed", or either. A module that reports "completed" on the last slide and "failed" on the quiz should not release the next lesson.
  • Where does the score go? Most WordPress LMS plugins have no gradebook, so the score usually lives in the add-on's own report. Check that it appears in the exports your managers use.
  • Does resume work? The bookmark is kept in cmi.suspend_data. Close the tab halfway and come back on another device.
  • What happens on a retake? Decide whether the best, the first or the last attempt counts, and see what the add-on stores.

The authoring tool has matching settings: its publish dialog decides whether the module reports slides viewed or a quiz result. A course that never completes is as often a publish setting as a site fault.

Which format to export from the authoring tool

FormatChoose it whenWatch for
SCORM 1.2You want the widest support and simple pass or complete trackingOne status field, and a small limit on resume data in the specification (4,096 characters), which long modules can exceed
SCORM 2004You need separate completion and pass status, or more room for resume dataSupport varies by edition, so confirm which one your add-on handles
xAPIYou want detail beyond pass or fail, or content that runs outside the LMS pageYou need an LRS, and someone has to decide which statements count
cmi5You want xAPI data with LMS-style launch and completion rulesThe thinnest support on WordPress, so verify import before you commit

If nobody has asked for xAPI data by name, publish SCORM 1.2 first. The body that stewards SCORM, the ADL Initiative, points new projects toward xAPI and cmi5, which is the right direction for new content programs. For getting an existing library online, the older format is the one every player handles.

Storage and hosting pitfalls

Most support requests we see about SCORM on WordPress are about the server, not the standard.

  • Upload limits. Packages with video are large. PHP's upload_max_filesize and post_max_size, and the web server's own body size limit, all have to allow the zip, and the unzip step needs time and memory.
  • Offloading to another domain. SCORM content finds the API by walking up to its parent window, and browsers only allow that when both pages share an origin. A media offload plugin that moves the unpacked files to a storage bucket or CDN hostname breaks tracking while the content still displays. Keep packages on the site's own domain unless the add-on documents a supported way around it.
  • Caching and script optimization. Exclude player pages and the add-on's AJAX or REST endpoints from page caching, and keep minify, defer and combine features away from the package's scripts.
  • Security headers and firewalls. A header that forbids framing blocks the player, and a firewall may treat a burst of small save requests as an attack. Allow same-origin framing and allowlist the tracking endpoint.
  • Long sessions. A learner who leaves a module open over lunch may return to an expired login, and the final save fails silently. Test a long idle period.
  • Backups and disk. Each package unpacks into hundreds or thousands of small files. Check that your backup tool and your hosting plan's file count limit can cope with the library.

Test one package before you upload the library

  1. Run the package on an independent test player such as SCORM Cloud first. If it misbehaves there, the fault is in the publish settings and not in your site.
  2. Upload it to a staging copy of the site and attach it to a lesson.
  3. As a test learner, start it, leave halfway, return on another browser and confirm it resumes.
  4. Finish with a failing score, then again with a passing one. Check lesson status, course progress, the certificate and the report after each run.
  5. Repeat on a phone, and with the browser console open to catch blocked requests.
  6. Then upload the rest, a few at a time.

When WordPress is the right home for packaged content

If packaged modules are part of a catalog that also has native lessons, a store and a marketing site, WordPress with a good add-on is a sound choice, and the setup above is something a careful site owner can do. If packaged content is nearly everything you deliver and detailed attempt reporting is the point, compare it with Moodle, which includes a SCORM 1.2 player in core. We cover that decision in Moodle vs WordPress LMS.

Bring in a developer when completion has to follow rules the add-on does not offer, when statements must flow to an external LRS or HR system, or when tracking fails and nobody can tell which layer is at fault. That is everyday work for our WordPress LMS development team, on LearnDash, LifterLMS and the other plugins we support.

Frequently asked questions

Does LearnDash support SCORM out of the box?

No. LearnDash's documentation says SCORM and xAPI packages need a third-party add-on. The add-on plays the package inside a lesson, topic or quiz and marks it complete from the data the package reports.

Do I need an LRS for SCORM on WordPress?

Not for plain SCORM, when the add-on stores results in the WordPress database and reports from there. You need one for xAPI and cmi5, and for add-ons that convert SCORM data into xAPI statements.

Can SCORM packages be hosted on a CDN or cloud storage?

Not by simply moving the files. SCORM tracking depends on the content and the player page sharing an origin, so content on another hostname displays but cannot report. Use a method your add-on documents, or keep the files on the site's domain.

Can a SCORM package be converted into normal lessons?

There is no reliable automatic conversion. A package is a small web application, not a set of pages. If you want native lessons and quizzes, go back to the source files in the authoring tool and rebuild the content, reusing the video, images and text.

Add WorldWin Coder to your preferred sources

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

Swati Priyadrshni
· Founder & CEO at WorldWin Coder

I'm Swati Priyadarshani, Founder & CEO of LMS Advisor and Co-Founder of WorldWin Coder Pvt. Ltd. (est. 2019). Over the last 10+ years, I've helped enterprises build learning platforms that actually get used - not just deployed.

Keep reading

Have something to build, fix or move?

Tell us where you are. A developer reads every inquiry, and you get next steps and a free quote within one business day.