How to Enable LMS Debug Mode

Tutorials & Guides
1

Hey Compozers!

If you ever need to troubleshoot communication issues between your LMS and a Compozer course (things like completion not tracking, progress not saving, etc.), enabling LMS Debug Mode can be really helpful.

By default, debug mode is turned off, but you can enable it across all LMS outputs — including SCORM 1.2, SCORM 2004, AICC, cmi5, and xAPI.

Here’s how to switch it on:

  1. Export your course as an LMS package and save the zip file to your computer.

  2. Extract the zip file containing your course, then open the scormdriver folder.

  3. Open the driverOptions.js file in a text editor, such as Notepad.

  4. Find the following line:
    scope.SHOW_DEBUG_ON_LAUNCH = false;

  5. And change it to:
    scope.SHOW_DEBUG_ON_LAUNCH = true;

  6. Save and close the driverOptions.js file.

  7. Re-zip the course files (not the folder containing them) and upload the zip file to your LMS.

  8. Launch the course from your LMS and reproduce the issue you’re troubleshooting. The course will open in one window, while the debug log will open in another.

This is super useful for identifying where things might be breaking down.

Hope that helps anyone digging into LMS tracking issues :+1:

For more information about all available driver options, see How To Use the driverOptions.js File.