SCORM Testing Guide

Before Uploading

How to test the SCORM files

The key behind testing the SCORM files is to take every possible path that a user could have taken while taking the course. Follow every possible series of steps, test all available buttons and moves.

Steps

1. Navigation Buttons
The first step is to test all buttons and navigation options available within the course.
• Verify that all buttons work as expected.
• Confirm that buttons appear at the correct time and in the appropriate sections of the course.

2. User Progress
The next step is to verify that learner progress is properly saved within the course. To test this, complete several slides or sections of the course and then close the course window as a learner normally would. Afterward, reopen the course.

• If a Resume button has been configured, verify that it appears as expected.
• Confirm that selecting Resume returns you to the exact point where you previously left the course.

3. Exams/Quizzes
When testing exams and quizzes, make sure to validate all possible learner outcomes, including both correct and incorrect answers.

• Verify what happens when a learner answers a question correctly.
• Verify what happens when a learner answers a question incorrectly.
• If learners are allowed to retry, confirm that they can change their answers and resubmit successfully.
• Test whether multiple incorrect attempts affect the final score, completion status, or course outcome as expected

4. Completion Tracking Validation

After completing all required steps within the course, close the course window and verify whether the lecture is marked as completed in Schoox.

• If the course is not marked as completed, reopen it and check whether any required steps or interactions were missed.
• Complete any missing steps and test the completion process again.
• If the course still does not return a completion status, review the SCORM export and completion settings within the authoring tool.

Please note that if, during testing, you identify steps that are easy for learners to miss but are required for course completion, you may need to adjust the course design or navigation to make those steps clearer and easier to follow

5. Mobile and Tablet

As a final step, test the same course functionalities on both mobile and tablet devices to identify any device-specific issues.

• Verify that navigation, buttons, interactions, quizzes, and completion tracking function correctly across devices.
• Confirm that the course layout and content display properly on different screen sizes and orientations.
• Check for any performance or usability issues that could affect the learner experience on mobile or tablet devices.

The final step is to test the same functionalities on a mobile and a tablet, in case we meet any issues with the file there.

Notes:
Please note that even after thoroughly testing a SCORM file and validating all expected learner flows, there may still be scenarios that are difficult to fully replicate during testing. These may include unexpected learner interactions, internet connection interruptions, browser-specific behavior, device limitations, or other environmental factors that can affect the learning experience.

Additionally, large SCORM files with extensive interactive content may be more susceptible to random issues related to browser performance, device resources, or unstable internet connections. Because these courses rely on a higher number of background processes and interactions, learners may occasionally encounter behavior that was not reproduced during testing.

While Uploading in Schoox
 

Before uploading your SCORM file to Schoox, it is recommended to first upload and test it in SCORM Cloud to verify that the course functions correctly there as well. SCORM Cloud is a global engine for validating and testing SCORM content, making it a useful tool for identifying issues related to course behavior, tracking, or completion settings before the file is distributed to learners.

If you are trying to upload a SCORM file, but an error message is replicated, please check the export settings of the file as most possibly this is a file issue. However, if this does not resolve the issue, please escalate the issue to Schoox Support for further testing.

After Uploading

Troubleshooting Steps

1. Verify whether the issue affects one or multiple learners

Start by determining whether the issue is isolated to a single learner or affects multiple users taking the same lecture. If several learners experience the same issue, the problem may be related to the SCORM file itself.

To review learner progress:

Academy Workspace → Training Admin → Courses → Search Course → Course Panel → Enrolled Learners → Course Dashboard

From the Course Dashboard, review the affected lecture and check the learner details, including:

• Attempts
• Time spent
• Progress bar status
• Completion status

Compare the reported learner with other learners enrolled in the same lecture to identify whether the issue is widespread or isolated.

2. Verify that the learner exited the SCORM lecture properly

If the issue only affects a single learner, the most common cause is that the learner did not exit the SCORM lecture correctly, preventing the progress from being properly saved and communicated to Schoox.

To verify this:

• Log in as the learner.
• Access the course and open the SCORM lecture.
• Exit the lecture using the expected exit process.
• Confirm whether completion is awarded correctly after exiting.

Useful Note: For learner progress in a SCORM lecture to be tracked correctly in Schoox, learners should avoid closing the browser window directly while the course is still open. Closing the browser abruptly may prevent progress and completion data from being saved properly.

Instead, learners should:

• Exit the lesson from within the SCORM course itself (for example, by selecting an Exit button if one exists).
• Wait for the confirmation message indicating that the course has been exited successfully.
• Close the lecture window by selecting the “X” button.
• Wait for the Schoox page to refresh before navigating away.

Following this process helps ensure that progress, time tracking, and completion data are properly recorded.

If the issue persists, continue to the next troubleshooting step.

3. Reproduce the issue using your own account

If the previous step was unsuccessful, or if the issue affects multiple learners, test the lecture yourself to reproduce the issue.

• Enroll yourself in the course.
• Launch the SCORM lecture.
• Complete the lecture from beginning to end.
• Exit the lecture properly using the recommended exit process.
• Verify whether the lecture is marked as complete for your account.

Useful Note 1: Make sure that you are enrolled in the course before testing. Otherwise, progress and completion data will not be tracked.

Useful Note 2: When testing a SCORM file:

• Interact with all buttons and interactive elements on each page.
• Avoid skipping or fast-forwarding videos or audio content.
• Complete all required interactions before exiting the course.

Some SCORM packages only report completion after all interactive elements have been viewed or completed successfully.

If the lecture is marked as complete for your account, advise affected learners to retake the lecture from the beginning while carefully following all required steps and interactions.

4. Escalate the issue to Schoox Support

If the issue still cannot be reproduced successfully or completion tracking continues to fail, escalate the issue to Schoox Support and include all troubleshooting steps already performed.

Helpful information to provide includes:

• Screen recordings 
• Browser console screenshots 
• .HAR file capture

You can read more about generating a  .HAR file on this article: Generating a HAR File

Issue type 2: The learner receives the message “This lecture is not supported on mobile devices. Please visit our website.”

Troubleshooting Steps

1. Verify whether the SCORM file is configured to support mobile devices

Some SCORM files are intentionally configured by the course creator or instructor to be unavailable on mobile devices. In these cases, learners attempting to access the lecture from a mobile device will receive the following message: “This lecture is not supported on mobile devices. Please visit our website.”

If this message appears, the lecture has most likely been configured to block mobile access intentionally.

2. Advise the learner to access the training from a desktop or laptop device

If mobile access is intentionally disabled for the SCORM lecture, instruct the learner to complete the training using a desktop or laptop browser instead.

This restriction is commonly used for courses that include:

- Complex interactions
- Unsupported mobile content
- Browser-specific functionality
- Large interactive elements that may not function properly on smaller screens

3. Enable mobile compatibility for the lecture (if desired)

 If you want learners to access the training on mobile devices, verify that the lecture has been configured as Mobile Compatible within Schoox.

To do this:

• Open the course settings.
• Locate the lecture containing the SCORM file.
• Verify that the Mobile Compatible option is enabled.
  
  

Issue type 3: The learner’s progress was lost or reset

Examples:

• “I had watched half of the lecture, but when I accessed it again my progress was gone.”
• “I had already completed this lecture and had 100% progress, but now it shows 0%.”

Troubleshooting Steps

Verify whether the SCORM file was recently updated

These types of issues are commonly related to updates made to the SCORM file after learners had already started or completed the lecture. Before testing the issue, review the lecture’s History section to check whether a new version of the SCORM file was uploaded recently.

There are two common scenarios when a SCORM lecture is updated:

1. Learners who had not completed the lecture before the update may lose their existing progress

If a learner had partially completed the previous version of the SCORM file and a new version is uploaded, their previous in-progress data may no longer be valid. As a result, the learner may lose the progress they had made in the older version of the file.

Useful Note

In Schoox, SCORM lecture progress is displayed only as:

• 0% (not completed)
• 100% (completed)

Intermediate progress percentages are not displayed for SCORM lectures.

2. Verify the “Lecture Progress” settings for completed learners

If learners who had previously completed the lecture now see their progress reset from 100% to 0%, review the course's Lecture Progress settings.

Specifically, verify the value selected under the For Updates option.

• If this option is set to No, uploading a new version of the SCORM file will reset completion progress for learners who had already completed the lecture.
• Depending on the selected configuration, learner completion records may either be preserved or reset after updates.

Reviewing these settings can help determine whether the progress reset was expected behavior following the SCORM update.

Issue type 4: The SCORM lecture is not opening or working

Example:

• “I’m trying to watch the lecture, but it is not opening.”
• “The lecture contains a SCORM file that is not working.”

Troubleshooting Steps

1) Test the lecture using your own account

Access the course and open the SCORM lecture using your own account.

• If the lecture opens and works as expected, continue to the next step.
• If the lecture does not open or does not work on your end, escalate the issue to Schoox Support.

When escalating, include:

• A screen recording of the issue
• Screenshots of any error messages
• The course and lecture details

2) Test the lecture by logging in as the affected learner

If the lecture works correctly from your own account, log in as the affected learner and try to reproduce the issue from their perspective.

To do this:

• Log in as the learner
• Access the course
• Open the SCORM lecture

There are two possible outcomes:

• The lecture works when logged in as the learner.
• The lecture does not work when logged in as the learner.

Follow the appropriate step below based on the result.

3) If the lecture works when logged in as the learner

If you are able to access and play the lecture while logged in as the learner, this usually indicates that the SCORM file and the learner’s course access are working correctly.

Inform the learner that the lecture was tested using their account and that everything appeared to function properly during testing.

Then, advise the learner to:

• Clear their browser cache and try accessing the training again.
• Reopen the training in an incognito/private browsing window.
• Try accessing the training from a different browser.

4) If the lecture does not work when logged in as the learner

Useful SCORM Settings in Schoox

When configuring and troubleshooting SCORM content, make sure to also review the SCORM-related settings available within your academy and courses in Schoox.

Academy-Level SCORM Settings

In the left navigation, make sure you are in the Academy Workspace.

When in the Academy Workspace, select Settings. 

From the left-hand panel, select the Training filter type.

Navigate to the Courses section and then Advanced Settings.

From there, you can find several options related to SCORM and AICC lectures.

Additionally, if your SCORM packages contain embedded quizzes or exams, you can configure whether these SCORM exams should appear on learners’ dashboards.
 

Course-Level SCORM Settings