Skip to main content
All CollectionsAdmin - KnowledgeTribal Habits and SCORM
Troubleshooting problems with SCORM files
Troubleshooting problems with SCORM files

In this article, we review common problems with SCORM and how to troubleshoot them (with our SCORM element, SCORM import, SCORM upload).

David King avatar
Written by David King
Updated over a week ago

The SCORM standard is an old and complex standard. Since SCORM files can be created from a wide variety of sources, and contain a huge variety of content and instructions, it is possible to encounter problems with uploads in our SCORM element. If so, this article can help you troubleshoot solutions before contacting our Support team.

NOTE: Often the problem with SCORM with the SCORM file itself. As Tribal Habits does not create your SCORM files, we cannot provide support for design or technical issues within your SCORM files. Please contact the provider of your elearning authoring software or SCORM files for help in those instances.

Idea #1 - Are you uploading a supported elearning format?

Our first two ideas will help if you are uploading a SCORM file into our SCORM element and the file is not verifying. In such cases, the element will not enabled the Save button and will be stuck trying to verify.

A common problem encountered at this point, is that you are not actually uploading a supported file format. Our SCORM element is integrated with SCORM Cloud and accepts the following formats:

  • SCORM 1.2

  • SCORM 2004

  • AICC

  • xAPI

  • cmi5

Please confirm your SCORM file is in one of these accepted formats.

Idea #2 - Are you uploading an actual SCORM file?

Another common problem which may prevent verification of your upload, is that you are accidentally uploading something other than a SCORM file. While this may seem obvious, it may be that you have exported a different type of file or been provided with something other than a SCORM file.

A SCORM file will be a .zip file. However, many other formats can also be saved in a .zip.

As a first step, you can open the .zip on your desktop to inspect the contents. While the contents of each SCORM file will differ, there should be an imsmanifest.xml file. If this file does not exist, it is possible you do not have a proper SCORM file.

We have seen examples of 'SCORM' files that are actually just exported HTML content (static website) or files saved in the native format of the elearning authoring tool that was used. It is important to verify that you are definitely using an actual SCORM file.

If you are unsure about your file, you can test it at SCORM Cloud. Create a free account at SCORM Cloud and upload your file there. It will provide a passed or failed response and details about your file.

Idea #3 - Do you need to whitelist SCORM Cloud?

Tribal Habits utilises SCORM Cloud for our SCORM element. If you are unable to load your SCORM files into our SCORM element, and you are certain that your file is SCORM compliant, then we should consider if your organisations firewall is blocking access to SCORM Cloud.

You will need to check this with your IT team. Ask them to verify that is 'whitelisted' (or not blocked) by your organisation's security software.

Idea #4 - Do you need to disable IP address validation?

If you are able to upload your SCORM file, but users cannot launch your SCORM, then you might need to disable IP address validation. This issue is very rare, and typically only impacts organisations which utilise a VPN or other IP masking security measures.

You can check with your organisation's IT team about this. If so, there is an option in the SCORM element you can check to "Disable IP address validation for explorers". Try checking that option and launching the SCORM again.

Idea #5 - Does your SCORM file have correct completion logic?

The next issue you may encounter is that your SCORM file verifies and launches, but does not seem to be sending the 'completion' status back to Tribal Habits when a learner finishes the SCORM.

In 99% of cases, this is caused by bad logic / sequencing in the SCORM file itself. To troubleshoot this, you will need to use the elearning authoring tool which created the SCORM file to check its completion settings.

  • First, are there any completion settings enabled? We have seen examples of SCORM files which have not enabled any completion logic. As a result, no 'complete' status is sent back to Tribal Habits by the SCORM file at any time.

  • Second, if completion settings are enabled, can they be achieved? We have seen examples of SCORM files which set completion when 10 quizzes are answered correctly, but only 9 quizzes are ask. We have seen examples of SCORM files which set completion when the number of viewed slides is 10, but only 9 slides exist.

Did this answer your question?