Looking for up-to-date Help documentation? Documentation for the latest releases of Totara is now available at totara.help!

Visit the new Help site

All pages

The SCORM/AICC module is a course activity which allows you to upload any SCORM or AICC package to your course.

Unenrolled users and site admins are excluded from the activity level SCORM report however they will be included in the SCORM report source when using Report Builder.

What is SCORM?

SCORM (Sharable Content Object Reference Model) is a collection of specifications that enable interoperability, accessibility and reusability of web-based learning content. SCORM content can be delivered to learners via any SCORM compliant Learning Management System (LMS) using the same version of SCORM.

SCORM definition from Wikipedia.

Using SCORM in Totara

Totara Learn fully supports the AICC and SCORM 1.2 specifications. It also supports the SCORM 2004 specification, with the exception of these extensions:

  • Content Aggregation Model
  • The Run-Time Environment
  • Sequencing and Navigation

SCORM 2004 packages that do not use these extensions should function correctly in Totara Learn.

  • When you notice there is a problem displaying characters correctly, it could be a misconfiguration of your server. Make sure that both httpd.conf (when using Apache) and php.ini are set to DefaultCharacterset = utf8 or switch the sending of a default character set off.
  • A SCORM package must contains in the root of the ZIP a file named imsmanifest.xml that defines the SCORM course structure.

Totara Learn can't create SCORM packages - the SCORM module is simply for deploying SCORM packages.

Creating a SCORM Activity

  1. Click Turn editing on.
  2. Click SCORM from the Add an activity menu.
  3. Enter an activity name, this appears on the course page for learners.
  4. Enter an activity summary.
  5. Click Choose or upload file.
  6. Select the zipped SCORM package (click upload file upload the package into the files area if not already done) by clicking Choose.
  7. Set the SCORM/AICC Settings (see below to learn more).
  8. Set the Activity completion settings if required.
  9. Click Save and return to course or Save and display.

Alternatively, once you are happy with the default settings for SCORM packages in your course, you can instead drag and drop the zipped SCORM package directly into the course (providing editing is turned on).

Next, select Add a SCORM package from the dialogue box and select Upload. Once you have uploaded your SCORM package you can still edit the settings as normal.

Dragging and dropping a SCORM package into a course.

It's possible to limit the viewing and launching of SCORM files using capabilities. The capabilities mod/scorm:launch and mod/scorm:view allow you to decide which roles can launch and/or view SCORM activities. 

Updating SCORM packages

There may be times when you need to update a SCORM package but need to retain the completion data and current learners' progress. For example, you may have updated text in an elearning module without adding new content. In order to retain this data, you need to ensure that the new SCORM package's IMS manifest file has the same item identifier as the current SCORM package.

If you need to update a SCORM package that is used in multiple courses, it is useful to turn on auto-updating. You can do this by following these steps:

  1. Within the required course, Turn editing on.
  2. Select SCORM from the Add an activity menu.
  3. Enter a name and description.
  4. Select the Add button () and select the repository containing your SCORM files.
  5. Select the zipped SCORM file.
  6. Select the Create an alias/shortcut to the file radio button, then Select this file.
  7. Set the Auto-update frequency setting.
  8. Select Save and display.

Now the SCORM activity will automatically check the selected repository (depending on the Auto-update frequency you selected) and update the activity with the latest ZIP file.

If you use the automatic update method described above, you still need to check that the current and new SCORM packages have the same item identifier in their IMS manifest files. If the new package has a different number, regardless of whether you update the SCORM automatically or manually, you will lose your completion and progress data.

SCORM settings

When using the single activity course format a number of SCORM activity options (for example the Learner skip content structure page setting) will not be available.


NameThe name of the SCORM activity as it will appear on the course page. It should be concise and descriptive.-
DescriptionA description of the SCORM activity, this is a good place to include any instructions and to give a brief summary of the purpose of the activity.-
Display description on course pageIf enabled, the description above will be displayed on the course page just below the link to the activity or resource.-


Package file

This is where you will need to upload the SCORM package file, either by dragging and dropping it into the upload area or by clicking the upload icon () and browsing for the file.

Auto-update frequency

This allows the external package to be automatically downloaded and updated:

  • Never.
  • Every day.
  • Ever time it's used.


Display package

In Current or New window, we recommend using the New window option to avoid learners closing the site when they may just want to close the SCORM.

WidthStage size width in either percent or pixels. To use a percentage you will need to put a percentage sign (%) after the number, e.g. 80%. Might be only viewable if you click Show more.
HeightStage size height in either percent or pixels. To use a percentage you will need to put a percentage sign (%) after the number, e.g. 50%. Might be only viewable if you click Show more.
OptionsThere are a series of check boxes for; Allow the window to be scrolledShow the directory linksShow the location barShow the menu bar, Show the toolbar, and Status.Might be only viewable if you click Show more.
Display activity nameWhether or not to display the activity name above the SCORM player.Might be only viewable if you click Show more.
Learner skip content structure pageChoose from; Neverfirst access, and always.Might be only viewable if you click Show more.
Disable preview modeIf this option is set to Yes, the Preview button in the view page of a SCORM/AICC Package activity will be hidden. The learner can choose to preview (browse mode) the activity or attempt it in the normal mode.

When a Learning Object is completed in preview (browse) mode, it's marked with browsed icon.

Might be only viewable if you click Show more.

Display course structure on entry pageHow the table of contents is displayed in the SCORM player.Might be only viewable if you click Show more.
Display course structure in playerHow the table of contents is displayed in the SCORM playerMight be only viewable if you click Show more.
Hide navigation buttonsHide or display the buttons to go to content in the SCORMMight be only viewable if you click Show more.
Show navigation

This setting specifies whether to show or hide the navigation buttons and their position.

There are three options:

  • No: Navigation buttons are not shown.
  • Under content: Navigation buttons are shown below the SCORM package content.
  • Floating: Navigation buttons are shown floating, with the position from the top and from the left determined by the package.
Might be only viewable if you click Show more.
From leftIf you choose Floating as the Show navigation option you can then set how many pixels from the left you wish for it to be displayed.Might be only viewable if you click Show more.
From rightIf you choose Floating as the Show navigation option you can then set how many pixels from the right you wish for it to be displayed.Might be only viewable if you click Show more.
Display attempt StatusThis preference allows a summary of the users attempts to show in the course overview block in My home and/or the SCORM entry page. 

Even when a SCORM package is completed, there can be a message that reads, You have SCORM packages that need attention on the My Learning page. This message is displayed by default for the course it's related to and the SCORM entry page. You can turn it off by editing the SCORM package and changing the option Display attempt status to No or Entry page only. This is currently expected behaviour.


Available fromYou can set a date and time that the SCORM activity will be available from. You will need to check the Enable box to use this.-
Available toYou can set a date and time that the SCORM activity will be available until. You will need to check the Enable box to use this.-


Grading methodLearning Objects: This mode shows the number of completed/passed Learning Objects for the activity. The max value is the number of Package's Learning Objects. 

If your SCORM package does report cmi.core.lesson_status, and does not report cmi.core.score.raw, then you should use this setting.

Highest grade: The grade page will display the highest score obtained by users in all passed Learning Objects.

If your SCORM package does report cmi.core.score.raw, and does not report cmi.core.lesson_status, then you should use this setting, Average grade, or Sum grade.

Average grade: If you choose this mode Totara will calculate the average of all scores. -
Sum grade: With this mode all the scores will be added.-
Maximum gradeAllows you to set the maximum grade available for this SCORM activity.-

Attempts management



Number of attempts

This defines the number of attempts permitted to users. It works only with SCORM 1.2 and AICC packages. SCORM2004 has its own max attempts definition.

The option to start a new attempt is provided by a checkbox above the Enter button on the content structure page, so be sure you're providing access to that page if you want to allow more than one attempt. An attempt is not complete until the cmi.core.lesson_status for the attempt is set to either completed or passed. After that, the Start new attempt checkbox is available to the learner.
Attempts grading

When you permit multiple attempts for learners, you can choose how to record the result in gradebook by first, last, average, or highest settings.

Force new attempt

If Yes, hides the Start new attempt checkbox and prevents review mode.

If No then SCORM allows a learner to return to the same attempt at any point and a new attempt is not possible unless the previous attempt has been set as; completed, passed, or failed. If the SCORM package does not do this, the learner will always re-enter the same attempt.

An attempt is not complete until the cmi.core.lesson_status for the attempt is set to either completed or passed. After that, the Start new attempt checkbox is available to the learner.


Lock after final attempt

When set to Yes this prevents the learner from running the SCORM lesson once they have used all all their allowed attempts.

An attempt is only considered finished if the SCORM package has a cmi.core.lesson_status of passed, failed, or completed.


Compatibility settings


Force completed

If enabled, the status of the current attempt is forced to completed.Only applicable to SCORM 1.2 packages.
Auto-continueIf Auto-continue is set to Yes, when a Learning Object calls the close communication method, the next available Learning Object is launched automatically. If it is set to No, the users must use the Continue button to go on.Auto-Continue will only move from one SCORM to the next in the same topic.
Auto-commit If enabled, SCORM data is automatically saved to the database. Useful for SCORM objects which do not save their data regularly.-
Mastery score overrides statusIf enabled and a mastery score is provided, then when Finish is called and if a raw score has been determined, then status will be recalculated using the raw score and mastery score, and any status provided by the SCORM (including incomplete) will be overridden.Only applicable to SCORM 1.2 packages.

Common module settings

See Common Module Settings to learn more.

Activity completion

Most of these setting are standard, for these please see Activity completion to learn more. 

However, listed below are some additional setting options for SCORM activities. 




Require minimum score

Enabling this setting will require a user to have at least the minimum score entered to be marked complete in this SCORM activity, as well as any other Activity Completion requirements.

Require statusChecking one or more statuses will require a user to achieve at least one of the checked statuses in order to be marked complete in this SCORM activity, as well as any other Activity Completion requirements.-
Require all scos to return completion statusSome SCORM packages contain multiple components or 'scos'. When this is enabled all scos within the package must return the relevant lesson_status for this activity to be flagged complete.


Restrict access

See Restrict Access to learn more.


See Tags to learn more.

SCORM reports

Once learners have started to take the SCORM activity you will be able to see reports on the usage of the package by clicking the Reports tab.

There are four different reports to view:

  • Basic report: Shows how many attempts each user has made, when they first and most recently accessed the activity. 
  • Graph report: Shows a bar chart of number of users and the percentage secured (how far they have gotten in their attempt). 
  • Interactions report: Allows you to see a summary of learners attempts along with questions, responses (given by the learner), right answers, and results.
  • Objectives report: If a SCORM package is set up to report course objectives then they will be reported on here. 

All reports (except the Graph report) can be filtered and exported to either ODS, Excel or text format. 

Plugin settings

As a site administrator you can set default values for the SCORM activity settings and also configure admin settings. This is done from the Administration block under Site administration > Plugins > Activity modules > SCORM package.

Alongside configuring preferred default settings you can define the following admin settings:


Disabling this setting allows Totara to store more data than the SCORM 1.2 specification allows. If your SCORM packages allow users to enter large amounts of text or if your package tries to store large amounts of data in the suspend_data field disable this.


You can choose to add an externally hosted SCORM package, either via URL.

You will still see the file picker option as well.


If enabled this allows a direct URL to a simple AICC package.


If enabled this allows AICC HACP external communication without requiring user login for post requests from the external AICC package.


Length of time in minutes that an external AICC HACP session can remain open.


Length of time in days to keep the external AICC HACP session data (a high setting will fill up the table with old data but may be useful when debugging).


The AICC standard for usernames is very restrictive compared with Totara, and allows for alphanumeric characters, dash and underscore only. Periods, spaces and the @ symbol are not permitted. If enabled, user ID numbers are passed to the AICC package instead of usernames.


If enabled (recommended) this prevents access to SCORM objects when JavaScript is not supported/enabled in a users browser. If disabled the user may view the SCORM but API communication will fail and no grade information will be saved.


Set a mask for the debug, so that the debug log only appears under certain conditions. For example, you can use a simple regex on <username>:<activityname> e.g. admin:.* will debug for admin user only.-

If enabled, SCORM packages can be downloaded only if the user has the course:manageactivities capability. If disabled, SCORM packages can always be downloaded (by mobile or other means).

On this page

The Totara Academy has a whole course dedicated to using SCORM in Totara Learn. Here you can learn more on how to use the SCORM module, see best practice, and give it a go yourself.

Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?