02 What the validator checks
The checks, what they mean and how to fix them
In the order an LMS meets them during an upload: the ZIP, the manifest, the structure, the launch file, the files, the paths and the scoring rules.
imsmanifest.xml at the root of the ZIP
What it means: The LMS looks for imsmanifest.xml at the top level only. Zip the folder instead of its contents and it ends up in course/imsmanifest.xml, so the LMS says "not a SCORM package". IMSManifest.xml fails on servers that compare names exactly.
How to fix it: Select everything inside the folder and zip that selection. Name the file imsmanifest.xml, in lower case.
A ZIP inside the ZIP, and system files
What it means: Some portals wrap the package in a second archive, so the LMS finds a .zip and no manifest. __MACOSX and Thumbs.db are just clutter.
How to fix it: Upload the inner ZIP; the validator names it.
Well-formed XML and the right schema
What it means: One unescaped & or unclosed tag makes the manifest unreadable. The root must be <manifest> in the IMS Content Packaging namespace: imscp_rootv1p1p2.xsd and adlcp_rootv1p2.xsd for SCORM 1.2; imscp_v1p1.xsd, adlcp_v1p3.xsd, adlseq_v1p3.xsd, adlnav_v1p3.xsd and imsss_v1p0.xsd for SCORM 2004.
How to fix it: Write & as &, re-export instead of editing by hand and keep the .xsd files next to the manifest.
SCORM version
What it means: <schemaversion> tells the LMS which runtime to start: 1.2, or CAM 1.3, 2004 3rd Edition or 2004 4th Edition. If it is missing or contradicts the namespaces, the LMS guesses and may hand the course the wrong API.
How to fix it: Make schemaversion and the namespaces agree.
Organizations, items and SCOs
What it means: Items point to resources through identifierref, and at least one resource must be a SCO: adlcp:scormtype="sco" in SCORM 1.2, adlcp:scormType="sco" with a capital T in 2004. Without a SCO the course opens but never reports. Duplicate identifiers break the links.
How to fix it: Use unique identifiers and mark the resource that talks to the LMS as a SCO.
Launch file
What it means: The launch file is the href of the SCO resource. If it is missing, learners get "page not found". Index.html instead of index.html works on Windows and fails on the Linux servers most LMSs run on. A leading / points outside the package.
How to fix it: Match the file name exactly, letter case included, as a path relative to the manifest.
Listed and missing files
What it means: Every <file href> should exist. Missing files become broken images, silent videos or a script error halfway through. Unlisted files are only a note. Paths that leave the package with ../ fail everywhere. xml:base is taken into account.
How to fix it: Re-export instead of deleting files by hand.
Spaces, special characters and backslashes
What it means: "Intro video.mp4" has to be URL-encoded, and servers do not all encode alike. Accented letters, # and ? break URLs. Backslashes are Windows separators some zip tools write into the archive.
How to fix it: Use lower-case letters, digits, hyphens and underscores, and a zip tool that writes forward slashes.
Pass mark and completion rules
What it means: adlcp:masteryscore (0–100) in SCORM 1.2 and imsss:minNormalizedMeasure (−1 to 1) in 2004 let the LMS set passed or failed from the score. Out-of-range values are errors. satisfiedByMeasure="true" without a minNormalizedMeasure means 1.0: learners need 100%.
How to fix it: Set the pass mark in the authoring tool, or leave it out when the course decides pass or fail itself.
Size, and packages that are not SCORM
What it means: The validator lists the largest files and warns above 100 MB, a common upload limit; yours depends on the platform and its settings. It also recognizes xAPI (tincan.xml) and cmi5 (cmi5.xml) packages and checks their basics: a well-formed file, activity IDs that are valid web addresses (IRIs), the launch file and, for cmi5, the completion and pass settings. AICC packages are recognized but not checked.
How to fix it: Compress videos and resize images. Upload xAPI, cmi5 or AICC to an LMS that supports them, or export SCORM.