Quiz Guide
Everything you need to create, manage, and deliver engaging assessments for your students.
info Overview
The Quiz Management Tool helps educators build interactive, flexible online assessments with ease. Whether you are running quick formative checks, practice activities, or major exams, this tool provides intuitive controls designed specifically for teachers.
Simple & Teacher-Friendly Interface
No coding or technical skills required. Focus on creating high-quality content using clean visual toolbars and easy drag-and-drop operations.
Rich Interactive Questions
Go beyond traditional multiple-choice questions with math equation editors, image tagging, word highlighting, sorting, and gamified options.
Built-in Quality Controls
Catch typos before publishing with automated spellcheck, preview your layout instantly, and adjust attempt or passing rules at any time.
bolt Quick Guide
New to the tool? Here is a high-level overview of the main controls and the recommended 4-step workflow to get your quiz ready quickly.
tune Top Menu Bar
- Check Language: Scans questions and choices for spelling or typo errors.
- Quiz Settings: Configure passing scores, time limits, and student feedback rules.
- Question Help: Opens this reference guide anytime.
dashboard Managing Questions
- New Question: Adds a new question card to your quiz.
- Collapse All: Shrinks question cards into a simple list for easy reordering.
- Import Questions: Bulk-load pre-made items from saved question banks.
Recommended Steps to Build a Great Quiz:
Configure passing grades, attempt limits, and feedback rules under Quiz Settings.
Add or import questions. Use different formats to keep practice engaging!
Click Check Language to automatically highlight potential typos in prompts or choices.
Use Collapse All to review sequence, then preview and publish for your class.
add_circle How to Create a New Quiz
Follow these simple steps to set up a brand-new quiz container in your course folder.
Step 1: Navigate to Your Subject Folder
Go to the course, module, or unit folder where you want students to access the quiz.
Step 2: Add Quiz Item
Click the Add New Item menu in the top toolbar and select Quiz.
Step 3: Enter Basic Information
Give your quiz a clear title (e.g., Chapter 3 Math Practice) and add brief instructions or context for your students in the description box.
Step 4: Save & Open Manage Screen
Click Save. You will automatically land on the Manage Quiz editing screen where you can begin adding questions!
edit_document How to Manage Quiz
The Manage Quiz editor allows you to add, organize, and tweak your assessment at any time.
Key Management Actions:
- Adding Questions: Click New Question and pick a category. A new card will appear at the bottom of your quiz.
- Reordering Questions: Click Collapse All to view your questions as compact headers, then drag and drop them into your preferred sequence.
- Duplicating Items: Use the copy icon on any question card to replicate complex items without starting from scratch.
- Deleting Items: Click the trash icon on a question card to remove it from the quiz.
Check Language
Runs a fast automated check across all prompts and choices to find typos, misspellings, or missing words.
Collapse & Expand All
Toggle between detailed editor views and compact list views to keep long quizzes clutter-free.
Import Questions
Import ready-to-use question sets from existing course files or shared question banks.
Upload Questions
Accelerate quiz creationg by uploading questions details with their optional settings from a JSON file.
Append or Add Question at Position
Click the plus circle icon at th quiz tool bar to append a new question to the quiz at the end or the icon located between questions to insert a brand new question precisely at that specific position in the quiz layout.
Search Questions
Quickly filter through long quizzes by typing keywords to instantly locate specific questions or prompts without endless scrolling.
Jump to Question
Select any question from the quick-jump index or search results to instantly scroll and focus directly on that section of the quiz.
Generate with AI
Opens a panel that drafts a full set of questions for you using the quiz's own title and description, plus anything you add: an optional source document (PDF, HTML, Markdown, or plain text) to base the questions on, how many questions to generate, additional instructions (e.g. "focus on real-world examples" or "avoid trick questions"), and an optional Year/Grade level. Generated questions land in the editor exactly like manually added ones - review, edit, or delete them before saving. Which question types the generator can produce depends on your subscription tier; drafting the questions themselves is a Premium feature.
settings Quiz Settings
The Quiz Settings button in the Manage Quiz toolbar opens a panel controlling how the quiz behaves for students taking it - separate from the questions themselves.
Mode: Exam / Practice / Both
Controls which modes a student can choose when starting the quiz. Exam typically hides answers until submission; Practice allows a more relaxed, learning-focused experience. Choosing "Both" lets the student pick.
Style: Steps / List / Both
Steps presents one question at a time with Next/Previous navigation; List shows every question on a single scrollable page. "Both" lets the student choose their preferred layout.
Theme
Selects the visual theme students see while taking this specific quiz.
Gamified Experience & Game Mode
Turns on score chips, streaks, sound effects, and a progress bar as students answer. Enabling a specific Game Mode goes further, turning the quiz into a light competitive game (e.g. a race) built on top of the same questions and grading.
Questions Order
When enabled, questions are presented in a different random order each time a student takes the quiz, instead of the fixed order they were added in the editor.
Labels
Tag the quiz with Subject/keyword labels for categorization and search. Pick from existing site-wide labels or type a new one to create it on the fly.
Built-in Tools
Choose which of the built-in student toolbar tools appear on this quiz - such as Export, Statistics, Whiteboard, Calculator, Dictionary, and Full Screen.
Additional Tools
Attach extra reference pages (organized by subject) as one-click tools available to students directly from the quiz toolbar while they work.
build Question Tools
Every question editor card includes helpful utility controls to simplify drafting and formatting.
Settings
Opens the custom options panel for the specific question to configure advanced parameters.
Save Question
Saves individual changes made directly to this specific question to the server via a quick patch without needing to save the entire quiz page.
Delete Question
Removes the question from the quiz entirely after a confirmation prompt.
Duplicate Question
Creates an exact copy of the current question, appending it right below as a new entry for rapid quiz building.
Move Up
Shifts the question position up sequentially within the quiz layout, automatically recalculating question numbers.
Move Down
Shifts the question position down sequentially within the quiz layout, automatically recalculating question numbers.
Drag to Reorder
Click and drag the drag handle indicator to drop a question into any precise spot in the quiz using interactive drop zones.
Editable Status
Indicates whether a question is currently open for editing or locked, such as imported read-only questions.
Visibility Status
Reflects the publication status, distinguishing between published items versus private or hidden question states. Note that visibilit status can be detected from the question left border as well (green = visible, light orange = private, dark grey = undecided for new questions).
border_color Rich Editor Guidance
The integrated rich text editor provides powerful tools to format text, highlight key instructions, render mathematical equations, construct diagrams, and attach media seamlessly.
style Callout Boxes
Select text and choose a callout type under the Styles dropdown:
- Info: Blue container for supplementary notes or hints (
callout info). - Stipulate: Purple container for rules, conditions, or rubrics (
callout stipulate). - Warning: Yellow container for caution notes (
callout warning). - Success: Green container for key takeaways or correct answers (
callout success). - Danger: Red container for critical alerts (
callout danger).
auto_fix_high Modern Typography
Enhance layout structure using predefined element styles:
- Stylish Quote: Formats selected text as an indented pull-quote (
.stylish-quote). - Note Box: Outlines text inside a clean content box (
.note-box). - Checklist: Turns bullet lists into styled checkable items (
.checklist). - Fancy Header: Adds decorative styling to
H2section titles (.fancy-header).
Interactive Authoring & STEM Tools
MathJax Equation Editor
Insert LaTeX formulas using the mathjax tool. Equations are rendered cleanly in $2\text{D}/\text{3D}$ typeset markup and automatically aligned within your question body.
Mermaid Diagrams
Build flowcharts, sequence diagrams, and system architecture charts using plain-text Mermaid syntax. Diagrams render live inside the editor with interactive preview wrappers.
Draw.io Diagram Builder
Launch an embedded vector drawing suite to sketch custom schematics, mind maps, flowcharts, and technical diagrams directly within the editor.
Chart Builder
Create visual data graphs (bar, line, pie, radar) using an interactive wizard interface to present empirical data to students.
Vector Shapes & Native SVG Support
Insert geometric vector primitives or paste raw SVG graphics directly into the HTML editor without markup stripping.
Speech to Text
Dictate question content hands-free using microphone voice recognition directly into the active editor field.
Language Check
Run automated grammar, spelling, and phrasing audits specifically tailored for multi-language or educational content.
Emoji Sound
Embed expressive emojis attached to interactive audio cues for audio-visual engagement in elementary or language practice.
code Code Sample Highlighting
Insert formatted, syntax-highlighted code blocks for programming assessments. Supported languages include:
- HTML / XML
- JavaScript
- Python
- Java
- C / C++
- CSS
- PHP
- SQL
attachment Media & Persistent Links
- Safe Image Scaling: Uploaded images are routed through automatic web scale preview targets (
teaser). - Persistent Plone Links: Documents and media use system Unique Identifiers (
resolveuid) so links remain valid even if target files are renamed or moved.
quiz Question Types
Explore all available question formats. Each item below provides details on how the question functions for your students.
One Answer
Choice-Based Free SubscriptionThe learner reads a question and selects exactly one answer from a list of options. Only one choice can be active at a time (radio-button behaviour). The answer is submitted and compared against the single correct option you define.
How to use
In the question builder, add as many option rows as you need and tick the one that is correct. At least two options are recommended to make the question meaningful.
Customisation
Random Options— shuffles the option list into a different order for each render, preventing positional memorisation.button-style-input— renders options as large clickable buttons instead of small radio circles; useful on touch devices or for younger learners.colored— cycles each option through a palette of soft background colours, making the list easier to scan visually.numbered/lettered(listing class) — prefixes options with 1 2 3… or A B C… automatically.
tips
Write distractor (wrong) options that are plausible — avoid obviously silly choices.UseRandom Options if learners might see the same question more than once.Four options is a common sweet spot; more than six starts to feel exhausting.Keyboard tips
- Use
Alt+ato select the right answer - Use
UpandDownarrows to move across items - Use
Enterto create a new item row - Use
Backspaceto remove an item and move up
Multiple Answers
Choice-Based Free SubscriptionThe learner reads a question and selects every option that is correct — there may be one, several, or all of them. Grading uses set equality: the learner's selection must match the correct set exactly (no partial credit, order does not matter, comparison is case-insensitive).
How to use
In the question builder, add your options and tick every row that is correct. Make sure your question wording signals that more than one answer may apply — e.g. "Select all that apply".
Customisation
Random Options— shuffles the option order on each render.button-style-input— renders options as large toggle buttons rather than checkboxes.colored— applies a soft colour cycle to each option for easier visual scanning.numbered/lettered(listing class) — prefixes each option with a number or letter automatically.
tips
Always tell learners that more than one option may be correct — the format is unfamiliar at first.Grading is all-or-nothing: selecting four out of five correct options scores zero. Adjust difficulty accordingly.Avoid questions where every option is correct — it reduces to a trivial 'select all' task.UseRandom Options so learners can't learn the pattern of which positions are usually ticked.Keyboard tips
- Use
Alt+ato select the right answer - Use
UpandDownarrows to move across items - Use
Enterto create a new item row - Use
Backspaceto remove an item and move up
Missing Word
Fill-in-the-Blank / Text Entry Free SubscriptionHow to Build
- Add Question Prompt: Write your question or incomplete sentence in the main question text box.
- Set the Correct Answer: Type the expected word or short phrase into the Correct Answers field.
Quick Authoring Tips
- Keep answers concise: Single words or 2–3 word phrasesyield the best results and prevent typing errors.
- Capitalization rule: Grading automatically formats thestudent's entry by capitalizing the first letter (e.g., typing "photosynthesis" or "PHOTOSYNTHESIS" will both match "Photosynthesis"). Avoid answers that rely on unusual middle-build_missing_word_html capitalization.
Number Range
Math & Science Plus SubscriptionNumber Range questions ask students to calculate a numeric value within an acceptable error margin.
Key Features:
- Supports absolute tolerance ranges (e.g., 9.81 ± 0.05).
- Supports physical units validation (e.g., m/s²).
- Optional live slider control display.
Classification
Ordering & Matching Premium SubscriptionExaminees drag items from an item pool into designated, labeled category containers. The question is graded as correct only when every item is placed into its correct category.
Raining
Ordering & Matching Premium SubscriptionLearner drags each item from a pool into the zone it belongs to; correct only when every item is placed in its correct zone.
The learner will view the items moving to capture and drop in its zone unless you choose to disable it.
You can enable Freeze Raining to stop animation and you can enable Randomize Options to randomize the order of the answer options
Image Tagging
Visual & Interactive Premium SubscriptionHow to Build
- Select Image: Choose or upload the background reference image.
- Position Drop Zones: Place target placeholders over key locations on the image.
- Add Label Pool: Define the draggable text options available.
- Set Correct Answers: Enter the correct text for each drop zone in order (one per line).
Quick Authoring Tips
- Dual Input Modes: Learners can drag labels or click drop zones to type directly.
- Positional Grading: All drop zones must hold their matching label for full credit.
Formula
Math & Science Plus SubscriptionHow to Build
- Set Target Expression: Enter the correct LaTeX mathematical expression into the Correct Answers field.
Quick Authoring Tips
- Symbolic Grading: Submissions are evaluated using symbolic mathematical equivalence rather than exact string matching (e.g.,
x+1and1+xboth evaluate as correct). - Math Input Editor: Learners interact with a visual
<math-field>editor component that automatically synchronizes with underlying LaTeX text.
Drag/Drop inplace
Fill-in-the-Blank / Text Entry Plus SubscriptionHow to Build
- Add Text & Placeholders: Write your question text and insert target dropzone markers like
1($),2($), etc., directly into the text prompt. - Add Option Pool: Enter the draggable options line-by-line in the Answers field (supports optional
value|htmlformat). - Set Correct Answers: Enter the correct answer for each dropzone line-by-line in the Correct Answers field in strict positional order (line 1 matches
1($), line 2 matches2($)).
Settings & Options
- Random Options: Shuffles the draggable options pool on each load.
- Lock Edit: Restricts dropzones to drag-and-drop interaction only, disabling direct text typing inside slots.
- Use answer once: Removes an option tile from the draggable pool once placed into a dropzone.
Quick Authoring Tips
- Positional Grading: Grading is case-insensitive but strictly positional; options must match their specific target dropzone index.
Identify Words
Text & Recall Premium SubscriptionHow to Build
- Provide Text Passage: Write the sentence or paragraph in the main question stem.
- Set Correct Words: In the Correct Answers field, enter the target word(s) or phrase(s), one per line.
Quick Authoring Tips
- Automatic Selectability: Every word in the text prompt is automatically clickable—no special tags or markup are required in your passage text.
- Case Sensitivity: Grading uses unordered, case-sensitive set matching. Ensure your correct answer entries match the exact capitalization in the passage.
Sort
Ordering & Matching Plus SubscriptionRandomize item order the learnerwill solve the question by ordering the items in the correct order. Items can be displayed to the learner in inline ordr if you enable Display items inline
Match
Ordering & Matching Plus SubscriptionHow to Build
- Define Column Items: Provide the items organized under two column headers (for example, Column 1: Countries, Column 2: Capitals)[cite: 9].
- Set Correct Pairs: In the Correct Answers key, enter each matching pair on its own line using a comma separator (e.g.,
France,Paris)[cite: 9].
Settings & Configuration
- Randomize Item Order: Enable Random Options to shuffle the display order of items within each column independently[cite: 9].
Quick Authoring Tips
- Learner Interaction: Learners click an item in the left column and then an item in the right column to draw a connecting line[cite: 9]. Double-clicking a drawn line removes the match[cite: 9].
- Case Sensitivity: Answer evaluation checks for exact case-sensitive matching between the configured pairs and learner selections[cite: 9].
Hangman
Gamified Premium SubscriptionHow to Build
- Set Target Word: Type the word or phrase to be guessed into the Correct Answers field.
- Add Formatted Display (Optional): Use
value|htmlif rich HTML formatting is needed for the answer review screen.
Settings & Configuration
- Language Support: The letter grid automatically adjusts to the target language defined on the question (such as standard English or Arabic keyboard layouts).
Quick Authoring Tips
- Lives Limit: Learners receive 10 lives per attempt. Each incorrect letter guess draws a portion of the figure and consumes one life.
- Grading Mechanics: The system automatically evaluates submission as pass/fail—submitting the fully uncovered word on a win or an empty response if all lives are lost.
Image slider puzzle
Gamified Premium SubscriptionHow to Build
- Select Puzzle Image: Upload or select an image to be sliced into the 3x3 sliding puzzle grid.
- Set Correct Answer: Type the expected answer into the Correct Answers field.
Quick Authoring Tips
- Grading Mechanics: Grading is based entirely on the typed text input (case-normalized), while the puzzle acts as an interactive visual reveal.
- Keep Answers Concise: Short 1–3 word responses yield the best learner experience.
Cannon
Gamified Free SubscriptionThe learner selects one or more correct options by rotating a cannon (a half-circle aiming range) and firing at whichever target is currently in its sights - the same underlying answer as Multiple Answers, just a different way of selecting it. Firing toggles that option on/off, so a student can correct a mis-aimed shot before moving on. Grading uses set equality (the same all-or-nothing rule Multiple Answers uses): the selection must match the correct set exactly.
How to use
Build it exactly like Multiple Answers: add your option rows and tick every one that's correct. The options become the cannon's targets, spread evenly across its aiming arc.
Gamified experience
Works with Quiz Settings' Gamified Experience exactly like every other question type - no special setup needed. With it on, Check Answer grades this question immediately; with it off, the student's shots are just recorded as normal answers, graded on submit.
tips
Works best with 3-6 targets - too many crowded onto the arc get hard to aim at precisely.Sound plays on every shot (Web Audio, synthesized - no audio file needed) regardless of whether the aim was actually correct, since correctness is never revealed while the student is still solving.Guess Word
Gamified Plus SubscriptionHow to Build
- Write the Clue: Enter the hint in the Title or Rich Details field — this is what the learner sees.
- Set the Secret Word: Enter the word to guess in the
Correct Answers field (e.g.
COSMOS). Uppercase is recommended but not required — grading is case-insensitive. - Set Max Trials (optional): Enter a whole number in the
Answer Options field (e.g.
6). Defaults to 4 if left blank.
How the Learner Plays
- One input box per letter appears automatically from the word length.
- After each guess, matched letters are shown in green; wrong positions show an underscore.
- A history panel records all previous attempts.
- Win: all letters match. Loss: trials exhausted without a correct guess.
Tips
- Works best with a clear, specific clue that narrows the answer to exactly one word.
- Suitable for vocabulary, science terms, geography, or any single-word fact the learner should recall.
Plugin
Ordering & Matching Plus SubscriptionHow to Build
- Column Titles: Set a label for the left column (draggable items) and the right column (fixed targets).
- Add Pairs: For each pair enter the left item text and its
matching right item text. Items support plain text, LaTeX
\( ... \), or HTML. - Correct Answer: The correct pairs are automatically stored as JSON — no comma-separation issues, so commas in item text are fine.
How the Learner Plays
- Puzzle pieces (left items) appear in a pool on the left.
- Each row on the right has a dashed socket and a fixed label.
- The learner drags a piece from the pool into the correct socket.
- Only one piece fits per socket; dropping a second piece returns the first to the pool.
Tips
- Works with LaTeX, SVG, and images in item text.
- Grading is order-independent — only the left→right pairings matter.
