How to Build a SCORM Course in the Browser, Step by Step
8 min read Czytaj po polsku
You don't need a desktop authoring tool or a developer to make a SCORM course. A browser and a plan are enough for a short module. We make Scormbee, so the last section shows how each step works there. Everything before it applies to any authoring tool.
Step 1: Write learning goals before you open any tool
Write three to five goals, each describing something the learner can do after the course. Slides, interactions and quiz questions all follow from this list.
"Understand phishing" is not a goal you can test. These are:
- Recognize three warning signs in a suspicious email.
- Check a sender's real address on desktop and mobile.
- Report a suspicious email with the Report button.
Use verbs you can observe: recognize, choose, order, calculate, decide. Avoid "understand", "know" and "be aware of".
Decide now if the course needs a pass mark: a graded quiz when learners must prove knowledge (compliance, safety), completion alone for onboarding information.
Step 2: Outline the course as slide titles
Turn each goal into two to four slides plus one practice activity, and write the outline as slide titles before any content. For the phishing course:
| # | Slide | Type |
|---|---|---|
| 1 | A real-looking fake email | Hook |
| 2 | What attackers want from you | Content |
| 3 | Check the address, not the display name | Content |
| 4 | Urgency and threats are a warning sign | Content |
| 5 | Hover before you click | Content |
| 6 | Safe or phishing? Sort six emails | Practice |
| 7 | Report it, don't reply | Content |
| 8 | Put the reporting steps in order | Practice |
| 9 | Your "manager" asks for gift cards | Scenario |
| 10 | Quiz: five questions | Assessment |
| 11 | Summary | Content |
Write titles as statements. "Check the address, not the display name" teaches something on its own. "Sender address" does not.
Step 3: Write slides with one idea each
One idea per slide, about 80 words of on-screen text at most. If a slide needs more, split it or move optional detail into an accordion or tabs.
- The headline carries the point; the body supports it.
- Lists of three to five items. Seven bullets is two slides.
- Cut warm-up sentences like "In this section we will look at…".
- Give every concept a concrete example.
- With narration, don't read the screen text aloud word for word. Show key phrases, explain in audio.
Before (42 words): "It is very important for all employees to be aware that phishing emails can often appear to come from trusted senders. Attackers frequently use the display names of people you know, while the actual email address belongs to a completely different domain."
After (23 words), under the headline "Check the address, not the name": "Attackers copy display names like 'IT Support'. The address tells you who really sent it. [email protected] is not acme.com, however official it looks."
Step 4: Choose interactions by what the learner must do
Pick the interaction that matches the verb in the goal. An interaction that only reveals content is a layout choice, not practice.
| The goal asks the learner to… | Interaction |
|---|---|
| Recall an exact term or value | Fill in the blanks |
| Connect pairs, such as terms and definitions | Matching |
| Put steps in the right order | Ordering |
| Classify items | Sorting into categories |
| Judge one claim | True or false |
| Decide in a realistic situation | Branching scenario |
| Explore optional detail | Accordion, tabs, hotspots on an image |
| Review key facts | Flip cards |
Aim for at least one "decide" interaction per goal. Feedback should explain why an answer is right or wrong, not only say "Correct".
Step 5: Write quiz questions that test the goals
Write at least one question per goal, make every wrong answer a mistake a real person would make, and explain the correct answer in the feedback.
- Put the full question in the stem. The learner should understand it before reading the options.
- Build distractors from real mistakes, not jokes.
- Skip "all of the above" and "none of the above".
- Keep options a similar length. A longest-is-correct pattern is a giveaway.
- Avoid negative stems. If you must, write NOT in bold.
- Shuffle answers unless the options have a natural order, such as numbers.
An example for the phishing course:
You get an email from "IT Support" asking you to confirm your password. The address is [email protected] and your company uses acme.com. What do you do?
A. Reply and ask whether it's genuine. B. Open the link to see if the page looks real. C. Report it with the Report button, then delete it. (correct) D. Forward it to colleagues as a warning.
Each wrong option is something people really do. Replying confirms your address is active, opening the link is the attack, and forwarding spreads it.
Pick a pass mark you can defend. With 10 questions, 80% lets the learner miss two. Use the same value in the course and the LMS; the SCORM versions article explains why.
Step 6: Check accessibility basics
Five checks catch most problems: alt text, contrast, keyboard, captions and color.
- Alt text. Describe what matters for learning. "Email where the sender name says IT Support but the address ends in acme-support.co" beats "screenshot of an email". Decorative images get empty alt text.
- Contrast. WCAG AA asks for 4.5:1 for normal text and 3:1 for large text (18 pt, or 14 pt bold). Check text on photos and buttons.
- Keyboard. Put the mouse aside and Tab through every slide. Every button, card and answer must be reachable, with a visible focus outline. Drag-and-drop needs a keyboard alternative.
- Captions and transcripts for video and narration.
- Not color alone. Red and green feedback also needs the words "Correct" and "Incorrect".
Step 7: Get a subject-matter review
Have someone who knows the subject check the content before LMS testing. Fixing content after upload means another upload. Send a review copy, collect comments per slide and fix everything in one pass.
Step 8: Test in a SCORM test environment
Test the exported ZIP in a SCORM test environment, then in your LMS. SCORM Cloud offers a free trial account and logs every API call.
- Launch: the course opens and nothing is blocked.
- Complete it: status becomes completed or passed.
- Fail on purpose: status and score are correct.
- Leave halfway and relaunch: you land on the right slide with answers kept.
- Check that answered questions appear as interactions.
- Run through it once on a phone and once with the keyboard only.
Then repeat steps 1 to 5 in your LMS as a test learner.
Step 9: Export and upload
Export SCORM 1.2 unless your LMS administrator asks for 2004, upload the ZIP unchanged and make the LMS settings match the course.
- Don't unzip the package.
imsmanifest.xmlmust sit at the root of the ZIP. - Choose whether the course opens in a new window or inside the LMS page. New windows run into popup blockers.
- Set what counts as complete and how many attempts are allowed.
- Enroll yourself first and check your own report line.
How this works in Scormbee
Scormbee runs in the browser, with an English or Polish interface. Mapped to the steps above:
- Steps 2 and 3: 11 slide layouts and 44 blocks, including narration you upload, record or generate with browser text-to-speech.
- Step 4: flip cards, accordion, tabs, steps, labeled graphics with hotspots, matching, fill in the blanks, ordering, sorting into categories, true or false and branching scenarios.
- Step 5: a scored quiz with single and multiple choice, shuffled answers, and practice or graded mode.
- Step 6: a WCAG AA contrast check, and the AI assistant can draft alt text.
- Step 7: a single-file review copy. Reviewers leave comments and you import them back.
- Step 9: export to SCORM 1.2, SCORM 2004 4th edition or a website ZIP. Every package you export opens again in Scormbee for editing.
The optional AI assistant uses credits. Its course wizard takes a brief and source files (PDF, DOCX, PPTX, TXT or Markdown) and shows an outline for you to approve before it writes slides. A 10–14 slide course costs about 11 credits; the free plan includes 25 credits once, 3 projects and all export formats. The AI writes a draft. Steps 1, 5 and 6 still need a human.
Still choosing a tool? See SCORM authoring tools compared.
Frequently asked questions
How many slides should a SCORM course have?
As many as the goals need. As a rule of thumb, one goal takes two to four slides plus a check, so a course with four goals usually lands at 10 to 14 slides.
Can I build a SCORM course without installing software?
Yes. Browser-based authoring tools run in a normal web browser and export a SCORM ZIP that you upload to the LMS. Desktop tools such as Storyline or Captivate must be installed.
How do I test a SCORM package before uploading it to the LMS?
Upload it to a SCORM test environment (SCORM Cloud offers a free trial account), then complete it, fail it, leave halfway and resume. Check that status, score and bookmark are recorded, then repeat the test in your own LMS.
Do I upload the SCORM ZIP or unzip it first?
Upload the ZIP as it is. The LMS expects imsmanifest.xml at the root of the archive, and unzipping and re-zipping often adds an extra folder level that makes the upload fail.