Why Moodle can’t read your Word file directly
Moodle has no importer for .docx files. Its Question bank › Import flow only understands structured interchange formats — most commonly QTI 2.1, GIFT, or Moodle XML. A Word document is just flowing prose and tables; it tells Moodle nothing about which paragraph is the question stem, which lines are the options, or which letter is the correct answer.
So the job is to translate your document into Moodle’s question model. The reliable way is a two-stage conversion: first parse the Word file into discrete, classified questions (number, stem, options, answer key, type), then serialize that into a Moodle-ready file. The first stage — reading the messy document — is where almost all of the real work lives.
The workflow at a glance
- Word .docx → classified questionsBreak the document into one question per unit — number, stem, options and answer key — and tag each with its type (MC, MR, T/F, short answer…).
- Classified questions → Moodle fileSerialize the same question set into QTI 2.1, GIFT or Moodle XML — whichever your workflow prefers.
- Moodle file → MoodleUpload it via Question bank › Import and the questions appear in your chosen category.
Step 1 — How ExamParser reads your Word document
The parser treats each question as a unit. For a typical multiple-choice item it extracts four things, then classifies the type and the correct answer from the structure and markers in your document:
| Part | What it captures | Example |
|---|---|---|
| Number | The question reference shown in Moodle (handy for tracking). | Q20 |
| Stem | The question prompt / body text. | What is 7 × 8? |
| Options | The answer choices, in order (a, b, c, d…). | a) 54 b) 56 c) 63 d) 49 |
| Answer key | The correct option(s), resolved to a 1-based index. Multiple correct answers become a multiple-response (MR) item. | 2 → option b; "2,4" → options b & d |
| Type | Classified from structure — MC, MR, T/F, short answer, etc. | MC, MR |
How do you actually run this conversion?
Re-typing hundreds of items by hand in the Moodle editor is slow and error-prone. The practical move is a tool that does both stages: read your .docx, classify every question, and export a Moodle format. ExamParser (word2moodle) is built for exactly this — upload a Word file and it returns the classified questions you can audit and the Moodle-ready QTI 2.1 / GIFT / XML file.
Step 2 — Choose a Moodle format: QTI 2.1, GIFT or XML
Moodle imports all three cleanly; they differ mainly in readability and portability:
| Format | Best for | Notes |
|---|---|---|
| Moodle XML | Full fidelity | Preserves categories, feedback and question metadata. The most complete export. |
| GIFT | Quick review | Plain text, the most human-readable — easy to spot-check or hand-edit before importing. |
| QTI 2.1 | Cross-LMS portability | Best if you also move questions between Moodle and other LMS platforms. |
Because all three come from the same parsed question set, you lose nothing by picking one — switch formats anytime without re-parsing the document. ExamParser exports the format you select in the same pass.
Step 3 — Import the file into Moodle
- In your course, open More › Question bank › Import.
- Choose the import format you exported — Moodle XML, GIFT, or QTI 2.1.
- Select the file from Step 2 and pick the destination category.
- Click Import and review the summary of questions added.
- Find the items under Question bank; preview, reorder, or add them to a quiz.
One tool for the whole pipeline: ExamParser (word2moodle)
ExamParser is built for this exact job — Word questions to Moodle. The part that makes it different is the middle step: it doesn’t just dump your document into an export. It first classifies every question — number, stem, options, answer key and type — and only then serializes that set into the Moodle format you choose. You can review the classified questions before exporting, so what lands in Moodle is exactly what you approved. No manual re-typing, no copy-paste, no silent mis-keying.
Turn your Word questions into a Moodle file
Upload a .docx and get Moodle-ready QTI 2.1, GIFT or XML — with the classified questions to review first.
Try ExamParser →Common pitfalls (and how to avoid them)
- Inconsistent numbering. Papers sometimes skip or repeat numbers. Confirm the parser’s detected numbers match your intent before exporting.
- Answers written as letters, not positions. An answer key like “a” must map to the 1st option. Let the tool resolve letters to 1-based indices; don’t hand-edit.
- Questions split across page breaks. A stem on one page and its options on the next can confuse naive parsers. Review items near page boundaries in the preview.
- Mixed question types in one file. That’s fine — the type is detected per question. Just keep the formatting consistent so detection stays reliable.
- Encoding issues. Accented characters and smart quotes can corrupt text. Export UTF-8 where possible; Moodle XML and GIFT both handle UTF-8 cleanly.
- Wrong format selected. Pick the format your Moodle import step expects; if you’re unsure, Moodle XML is the safest default.
Can Moodle import a Word .docx file directly?
No. Moodle’s question bank imports structured interchange formats — QTI 2.1, GIFT or Moodle XML — not Word documents. A .docx first has to be parsed into individual questions (number, stem, options, answer key) and then converted into one of those formats.
Which Moodle format should I export — QTI 2.1, GIFT or XML?
All three import cleanly. Moodle XML is the most complete (it preserves categories, feedback and question metadata). GIFT is the most human-readable and easy to spot-check. QTI 2.1 is the best choice if you also work across multiple LMS platforms. ExamParser exports all three from the same parsed question set, so you can pick whichever your workflow prefers.
How does ExamParser know the question type and the correct answer?
It reads each question apart — the number, the stem, the option list, and the answer key — and classifies the type (multiple choice, multiple response, true/false, short answer, etc.) from the structure and markers in your document. You can review the classified questions before exporting, so what lands in Moodle matches what you approved.
My Word file mixes multiple question types. Will it work?
Yes. Moodle accepts mixed question types in a single import file. ExamParser classifies each question row-by-row and writes the correct element for each type into the exported file, so a document with MC, MR, T/F and short-answer items imports as one batch.
Where do the imported questions end up in Moodle?
They land in the question bank category you choose at import time (Question bank › Import). From there you can preview them, move them between categories, or add them to a quiz.
MoodleQTI 2.1GIFTMoodle XMLWord to MoodleExamParser