Skip to main content

LMS

SCORM Package Integration​

Welcome! This guide walks you through how to integrate a PuzzleMe™ SCORM package into your LMS. If you already have the SCORM package .zip file, you’re just a few steps away from embedding engaging puzzles into your course. Below is a short video which takes you through the process.

What You Need​

Before proceeding, make sure you have:

  • A SCORM-compatible LMS (e.g., Moodle, Canvas, Blackboard, TalentLMS, Docebo)
  • The SCORM .zip file for the puzzle you want to integrate
  • Course creation or content editing permissions in your LMS

What’s Inside the SCORM Package?​

Each SCORM package includes:

  • An HTML wrapper that embeds the puzzle inside an iframe
  • JavaScript that communicates with the LMS via the SCORM 1.2 API
  • A manifest file (imsmanifest.xml) that defines how the content is registered with your LMS

All this is bundled and ready to import into your LMS. You don't need to make any changes to the package.

Step-by-Step Integration Instructions​

  1. Log In to Your LMS

Log in as an instructor or administrator with permission to edit course content.

  1. Navigate to Your Course
    Open the course or learning path where you want to embed the puzzle.

  2. Add a New Activity/Module

Look for an option like:

  • Add Activity or Add Resource (Moodle)
  • Add SCORM/AICC (Canvas)
  • Upload SCORM Package (TalentLMS)
  • Add Learning Object (Blackboard)

Choose the SCORM-type activity.

SCORM package option in TalentLMS
  1. Upload the SCORM Package

Upload the .zip file as-is—do not unzip it. The LMS will read the manifest and load the HTML file internally.

SCORM package upload window in TalentLMS
  1. Configure SCORM Settings (Optional but Recommended)

Depending on your LMS, you may be able to configure:

SettingRecommended Value
Display Mode"In a new window" or "In iframe"
Grade SettingsEnable, if the puzzle has scoring
Completion TrackingBased on student viewing or completion
Attempts Allowed1 or unlimited, depending on use case

💡 For non-contest mode puzzles, the SCORM module will automatically send a scaled score to your LMS.

  1. Save and Test

Save the module and test it by launching it from a student’s perspective:

  • Confirm the puzzle loads
  • Try completing it
  • Check that completion status (and score, if applicable) is recorded in the LMS

Data Privacy and Tracking​

The SCORM package does not track or store any personally identifiable information on our servers. A unique, anonymized identifier is generated within the LMS using the student's ID and name, strictly for puzzle session management. All puzzle score data is polled back to your LMS and is available for viewing within your LMS's reporting systems.

FAQ​

What if I want to include multiple puzzles in one module?

A: By default, each SCORM package includes one puzzle. If you need multi-puzzle support in a single package, please contact our team for a custom setup.

How do I track students' progress?

A: Use your LMS's reporting tools. The SCORM package updates:

  • Lesson Status: Set to completed when the puzzle is solved or submitted.
  • Score: A scaled score for the puzzle. Currently available only for non-contest mode puzzles.
I need assistance with the particular LMS I am using.

A: Reach out to our Product Support Team with the name of your LMS, the puzzle identifier, and a description of the issue. We're happy to help!