Skip to main content

SCORM Packaging

Exporting lessons and courses as SCORM 1.2 and SCORM 2004 packages for LMS deployment, enhanced SCORM settings, static vs dynamic packages, firewall/network allowlist domains, grey screen troubleshooting

J
Written by Justin

Export a Mindsmith lesson or course as a SCORM package to deliver it through a Learning Management System (LMS). A compatible LMS can track learner progress, completion, and scores from the package.

This guide explains how to export a package, choose a package type, and deploy it to an LMS.

Exporting a SCORM package

Before exporting, ensure your lesson is fully generated. You cannot export a lesson that is still only in Storyboard mode.

To export your lesson or course as a SCORM package:

  1. Open your lesson or course in the Mindsmith editor.

  2. Click the Share button located in the top toolbar.

  3. Click Download LMS package to open the Export to LMS dialog.

  4. Select your preferred LMS format (SCORM 1.2 or SCORM 2004). Enterprise lesson exports may also offer experimental xAPI packages.

  5. Select your Package type (Dynamic or Static).

  6. Under Completion, choose how to Report status to your LMS as. Match what your LMS expects.

  7. Click Export package.

Dynamic packages download through your browser right away. Static packages can take several minutes to build. If the dialog says Mindsmith will email you a download link, you can close it and keep working; otherwise, keep it open and the package downloads when it's ready.

Upload the ZIP file to your LMS as a SCORM package, without unzipping it. Most LMSs have a dedicated SCORM upload; a general file upload area won't run the package.

Choosing an LMS format

When downloading your package, you will be prompted to choose a format. This depends entirely on what your LMS supports.

  • SCORM 1.2: Choose this when your LMS requires a SCORM 1.2 package.

  • SCORM 2004: Choose this when your LMS requires a SCORM 2004 package. If you are unsure which format to select, consult your LMS administrator or documentation.

Dynamic vs. Static packages

Mindsmith offers two distinct ways to package your SCORM files. Understanding the difference will help you choose the best deployment method for your organization.

Dynamic packages (recommended)

A Dynamic package embeds the live Mindsmith player in your LMS instead of bundling all media files into the package.

  • Automatic Updates: If you fix a typo in a text tile or update an image tile in Mindsmith, those changes instantly appear in your LMS. You do not need to re-download and upload the SCORM package.

  • Requirements: Your learners must have an active internet connection, and their network must allow access to Mindsmith's servers (see Network Requirements for Dynamic Packages below).

Dynamic SCORM does not include a date-and-time scheduler for future updates. Without Staging, saved changes are available to the Dynamic package immediately. For lessons, Staging (Business and Enterprise plans) lets you keep edits separate from the live version, but an author must select Publish Changes when the update should go live; the existing LMS package does not need to be replaced.

Static packages

Static packages bundle all of your content, including every text, image, and question tile, into a single self-contained ZIP file.

  • Self-contained Mindsmith content: The package hosts supported lesson content and uploaded assets in your LMS, so it does not need Mindsmith's servers at play time. Embedded or linked third-party content can still require internet access to its provider.

  • Manual Updates: If you make changes to your lesson in Mindsmith, you must download a new static SCORM package and upload it to your LMS to see the updates.

Static Package Limitations: Some interactive tiles that require a live server connection are not included in static exports. Conversation tiles are automatically removed from static SCORM packages because they require a real-time AI connection. If your lesson relies on conversation tiles, use a Dynamic package instead.

What your LMS receives

Dynamic and Static packages report the same information to your LMS. SCORM 2004 packages use SCORM 2004 3rd Edition.

For each learner, the LMS receives:

  • Completion and pass/fail status, plus a score from 0 to 100 when the content is scored. A course package reports one status and score for the whole course. The LMS Reporting Mode in Lesson & Course Settings controls which status is sent.

  • Progress through the content (SCORM 2004 only).

  • Each answered question as a SCORM interaction: the learner's response, the correct response where there is one, whether the answer was correct, when it was answered, and for most question types how long the learner took. SCORM 2004 interactions also include the question text. Optional questions and questions that don't count toward the score aren't sent.

  • Session time, described below.

Retakes and multiple attempts

The LMS stores one status and score for each learner, so it shows the result of the learner's most recent attempt. In SCORM 2004 packages, restarting the content sets the status back to incomplete until the learner finishes again. In SCORM 1.2 packages, a passed status stays in place even if a later attempt scores lower.

Answers are added as new interactions instead of replacing earlier ones, so within the same LMS attempt the LMS keeps the answers from every Mindsmith attempt. With a Dynamic package, Mindsmith analytics also keeps each attempt's score, answers, and time.

Session time

Each time a learner opens the package, it reports how long that session has been open. Session time doesn't pause when the learner switches tabs or steps away, and most LMSs add sessions together to show a total. LMS time is therefore usually higher than the time in Mindsmith analytics, which pauses when the lesson isn't in front of the learner. See Analytics & Reporting for how Mindsmith measures time.

Network requirements for Dynamic packages

When a learner launches a Dynamic package, the SCORM file in your LMS loads the lesson live from Mindsmith's servers. On locked-down corporate networks, firewalls or web filters can block that connection: the course then shows a silent grey or blank screen. Because network policies often differ between offices or regions, this can affect only some of your learners while others in the same organization are unaffected.

If your organization (or your learners' organizations) filters web traffic, send your IT or network team the Network & Firewall Requirements article. It lists every domain to allow and includes a live network check you can run on an affected computer.

If your organization cannot allow Mindsmith's domains, use a Static package instead: it is fully self-contained and does not need to reach Mindsmith's servers at play time.

Branding and white-labeling in SCORM

Is Mindsmith branding visible to learners in a Dynamic SCORM package?

Dynamic packages load your lesson inside an iframe that points to the Mindsmith app. Whether Mindsmith branding appears depends on your plan:

  • Free plan: A "Powered by Mindsmith" badge is displayed at the bottom of the lesson. This cannot be removed on the Free plan.

  • Paid plans: The "Powered by Mindsmith" badge is automatically hidden. You can also upload your own organization logo in Lesson Settings, which will appear in place of any Mindsmith branding.

A Dynamic package always follows your current plan, so if the workspace moves to the Free plan, the badge reappears in packages already in your LMS. A Static package keeps the branding it was exported with. Packages you export keep working if you change plans.

Removing access to an exported package

A Static package contains the full lesson, so it keeps working in the LMS until the LMS admin removes it.

A Dynamic package loads the live lesson, so it stops working only when the lesson or course is permanently deleted in Mindsmith. Turning off public access or moving the lesson to Trash doesn't stop it. Permanently deleting cuts off every LMS using that package and removes the lesson's learner records, so duplicate the lesson first if you still need it; the copy gets a new link, and you can export a new package from it.

Common issues and practical tips

My SCORM package is showing an error in the LMS Contact Mindsmith Support with your LMS name, the lesson or course link, and a screenshot of the error. A network block shows a grey or blank screen (see below), not an error message.

My Dynamic package shows a grey or blank screen A blocked connection to Mindsmith is a common cause. As a quick check, open the lesson or course's share URL directly in a browser on the same device, outside the LMS. If that page is also blank, run the learner network check and share its results and the Network & Firewall Requirements article with your IT or network team. If your network cannot allow Mindsmith, switch to a Static package.

My updates aren't showing up in the LMS If you exported a Static package, you must generate and upload a brand-new package to your LMS to see changes. If you are using a Dynamic package and have Staging enabled, ensure you have clicked Publish Changes in the Share menu.

Interactive features are missing in my static SCORM export Static packages do not support tiles that require a live server connection. The export removes Conversation tiles. The "Require Interactives" lesson setting controls learner navigation within the Mindsmith player and may not work in every static SCORM configuration. Use a Dynamic package when the lesson depends on these features.

Did this answer your question?