UniQuiz Guide & FAQ

The complete workflow

Getting started

1. Prepare a CSV or TXT file.Use a recognizable question, answer, and answer-key structure.
2. Open UniQuiz.Select Start converting from the homepage.
3. Select your file.Your browser reads it locally; question content is not intentionally uploaded.
4. Acknowledge the Terms and Privacy Notice.This is required for each new conversion before the file is analysed.
5. Review detection.Check question counts, answer types, warnings, and any requested CSV column mapping.
6. Choose options.Configure shuffle, names, source-question-number removal, capitalization, and Moodle answer choice labels.
7. Review readiness.Check the whole-bank Ready, Warning, and Error summary and any actionable question diagnostics.
8. Generate XML.UniQuiz builds and validates the Moodle XML in your browser when no blocking error remains.
9. Import into Moodle.Download the XML and import it manually into the relevant Moodle question bank.

Spreadsheet-friendly input

CSV format

Basic CSV remains a small, unchanged subset for straightforward Multiple Choice authoring. Advanced CSV adds Moodle metadata and supports Multiple Choice, True/False, Short Answer, Numerical, Essay and Description rows. Both use the same header-based UniQuiz CSV parser and canonical question model.

You do not need to keep every Advanced CSV column. UniQuiz identifies supported fields by header name, optional columns may be omitted, and supported columns may appear in any order.

Basic CSV

question_text,answer_1,answer_2,answer_3,answer_4,correct
What is the capital of Hungary?,Vienna,Budapest,Prague,Warsaw,B
Select the prime numbers,2,3,4,6,"A,B"

Basic CSV scoring uses the correct answer-key column: one label such as B creates a single-answer question, while multiple labels such as A;B create a multiple-answer question. The aliases Correct answer, Answer key, and Key are also supported for this Basic field.

Advanced CSV

Advanced CSV uses the type field, type-specific answer fields where applicable, plus optional Moodle metadata and feedback. Different supported types may appear in different rows. Use the canonical lowercase snake_case headers below. Optional columns can be left out, and supported columns can appear in any order.

• multichoice — Multiple Choice
• truefalse — native True/False
• shortanswer — one or more accepted text answers
• numerical — numeric answer with optional tolerance
• essay — manually graded written response
• description — informational text displayed in the quiz

Supported Advanced CSV headers

• Advanced scoring uses numeric answer_N_fraction values. Do not mix explicit fractions and the Basic correct field in one row.
• Header matching trims whitespace, ignores case, and treats spaces or hyphens as underscores.
• Unknown columns are ignored with a warning; they are never guessed. Duplicate logical headers are blocking errors.
• Quoted commas, escaped quotes, multiline quoted fields, UTF-8, and UTF-8 BOM are supported.
• A separate two-column question,answer file may use only true or false; UniQuiz expands each row into two Moodle multichoice options.
• When enabled, Remove question numbering strips clearly detected prefixes such as 1., 51), Q101., or Question 20:. Decimal values, quantities, years, durations, measurements, and digit-leading identifiers remain unchanged.

Download Basic CSV ↓ Download Advanced CSV ↓ Download six-type example ↓

Plain-text input

TXT format

TXT is flexible, but each question still needs recognizable answer labels and an ANSWER: line.

What is the capital of Hungary?
A. Vienna
B. Budapest
C. Prague
D. Warsaw
ANSWER: B

Which are prime numbers?
A) 2
B) 3
C) 4
D) 6
ANSWER: A,B

Answer labels may use A., A), or A:. Common multiple-answer forms include A,B, A;B, A + B, and A & B. If a block is genuinely ambiguous, UniQuiz reports an actionable error.

Repair Moodle’s plain-text import format

AIKEN Fixer

AIKEN is Moodle’s simple plain-text format for single-answer multiple-choice questions. A valid question and every answer occupy one line, each option begins with an uppercase letter plus . or ) and a space, and the final line names exactly one correct answer.

What is the capital of Hungary?
A. Vienna
B. Budapest
ANSWER: B

Formatting matters because Moodle identifies questions, choices, and answer keys from their line prefixes. Open AIKEN Fixer to upload or paste a UTF-8 AIKEN file and download corrected AIKEN text—not Moodle XML.

Safe fixes and review changes

Safe fixes normalize structural spacing, tabs, uppercase labels, ANSWER: B, repeated blank lines, and supported option punctuation. Multiline questions, multiline answers, and question-number prefixes require explicit review because joining or removing text could affect meaning.

Limits and content protection

• Standard Moodle AIKEN supports one correct answer only. Constructs such as ANSWER: A,C are blocked.
• Use one line for each question and answer. Approve a proposed multiline join only after checking the wording.
• UTF-8 and non-Latin text are preserved. A UTF-8 BOM can be removed safely.
• The fixer changes structure only. It does not rewrite grammar, spelling, facts, formulas, HTML-like text, punctuation inside educational wording, or translate content.
• Processing stays in browser memory. No AI, API, database, analytics, local storage, or direct Moodle connection is used.

Automatic or explicit Moodle grading

Multiple correct answers

In Basic CSV or structured TXT, list every correct label on the answer-key line:

ANSWER: A,C

UniQuiz calculates equal positive Moodle grading fractions automatically. In Advanced CSV, provide explicit fractions such as 50, 50, 0, and -25 for finer grading. Positive fractions must total 100. Single- and multiple-answer questions may appear in the same file.

Whole-bank readiness

Preview diagnostics

UniQuiz validates every detected question before deciding whether Moodle XML can be generated, including questions hidden by search, filtering, or pagination. Each question receives exactly one state: Ready, Warning, or Error. A question with several diagnostics is counted once at its highest severity.

Search runs across the complete bank using case-insensitive Unicode substring matching over source question number, question name/text, answers, category, tags, and feedback. All, Warnings, and Errors intersect with the current search and preserve source order. Filter badges remain whole-bank counts; a separate result message describes the current match set. Clear Search preserves the active filter, while Show all questions switches the filter to All and preserves the query.

The result set is paginated at 20 questions by default; choose 50 or 100 when useful. Search, filter, and page-size changes return to page 1. Large-bank preview work remains limited to the visible page. Cards begin compact and create their read-only answers, scoring fractions, feedback, metadata, and diagnostics when expanded; collapsing removes those details again. Expansion resets when you navigate to another page.

• Ready means no issue needs review.
• Warning means the question remains exportable, but a deterministic condition such as duplicate answer text deserves review.
• Error means the full question bank cannot safely be exported until the source question is fixed.

Import/file warnings, such as an ignored unknown header, remain separate from question counts. Blocking file errors and any question error disable Generate Moodle XML even if the Error is hidden by search or the Warnings filter. UniQuiz never silently drops invalid questions. Card labels use the original canonical source question number, not the visible result position. Search terms, filters, validation, and diagnostic data stay locally in browser memory and are not persisted.

Diagnostics now explain what failed, identify the CSV row/column, question, field, answer, or TXT source line when available, and describe the smallest useful fix. Malformed CSV quoting and uncertain CSV mappings appear as actionable import guidance. These details do not change successful conversion, Ready/Warning/Error semantics, or export blocking.

Converter options

Settings explained

International question banks

Unicode and non-Latin characters

UniQuiz uses UTF-8 throughout parsing, preview, naming, and XML generation. It supports text in Hungarian, Cyrillic, Greek, Arabic, Hebrew, Chinese, Japanese, Korean, Vietnamese, and other Unicode writing systems.

Save input files as UTF-8. If the browser cannot safely decode a file as UTF-8, UniQuiz stops and asks you to resave it instead of corrupting the text.

After conversion

Importing into Moodle

1. Open the relevant question bank in Moodle.
2. Choose the question-bank Import action.
3. Select Moodle XML format.
4. Upload the XML file generated by UniQuiz.
5. Review Moodle’s import result before using the questions in production.

UniQuiz does not connect to Moodle or upload questions directly. Exact navigation may vary by Moodle version, theme, permissions, and organization.