help

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.

auto_awesome

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.

extension

Rich Interactive Questions

Go beyond traditional multiple-choice questions with math equation editors, image tagging, word highlighting, sorting, and gamified options.

spellcheck

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:

1. Adjust Settings
Configure passing grades, attempt limits, and feedback rules under Quiz Settings.
2. Create Questions
Add or import questions. Use different formats to keep practice engaging!
3. Proofread
Click Check Language to automatically highlight potential typos in prompts or choices.
4. Review & Launch
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.

folder_open

Step 1: Navigate to Your Subject Folder

Go to the course, module, or unit folder where you want students to access the quiz.

add_box

Step 2: Add Quiz Item

Click the Add New Item menu in the top toolbar and select Quiz.

edit_note

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.

save

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.
spellcheck

Check Language

Runs a fast automated check across all prompts and choices to find typos, misspellings, or missing words.

collapse_all

Collapse & Expand All

Toggle between detailed editor views and compact list views to keep long quizzes clutter-free.

input

Import Questions

Import ready-to-use question sets from existing course files or shared question banks.

upload

Upload Questions

Accelerate quiz creationg by uploading questions details with their optional settings from a JSON file.

add_circle

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

Search Questions

Quickly filter through long quizzes by typing keywords to instantly locate specific questions or prompts without endless scrolling.

jump_to_element

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.

auto_awesome

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.

school

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.

view_agenda

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.

palette

Theme

Selects the visual theme students see while taking this specific quiz.

stadia_controller

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.

shuffle

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.

sell

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.

construction

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.

folder_open

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

Settings

Opens the custom options panel for the specific question to configure advanced parameters.

save

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

Delete Question

Removes the question from the quiz entirely after a confirmation prompt.

control_point_duplicate

Duplicate Question

Creates an exact copy of the current question, appending it right below as a new entry for rapid quiz building.

arrow_upward

Move Up

Shifts the question position up sequentially within the quiz layout, automatically recalculating question numbers.

arrow_downward

Move Down

Shifts the question position down sequentially within the quiz layout, automatically recalculating question numbers.

drag_indicator

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.

lock

Editable Status

Indicates whether a question is currently open for editing or locked, such as imported read-only questions.

visibility

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 H2 section titles (.fancy-header).

Interactive Authoring & STEM Tools

functions

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.

account_tree

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

Draw.io Diagram Builder

Launch an embedded vector drawing suite to sketch custom schematics, mind maps, flowcharts, and technical diagrams directly within the editor.

bar_chart

Chart Builder

Create visual data graphs (bar, line, pie, radar) using an interactive wizard interface to present empirical data to students.

shapes

Vector Shapes & Native SVG Support

Insert geometric vector primitives or paste raw SVG graphics directly into the HTML editor without markup stripping.

mic

Speech to Text

Dictate question content hands-free using microphone voice recognition directly into the active editor field.

translate

Language Check

Run automated grammar, spelling, and phrasing audits specifically tailored for multi-language or educational content.

volume_up

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 Subscription
Learner selects exactly one correct option from a list.

The 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.Use Random 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+a to select the right answer
  • Use Up and Down arrows to move across items
  • Use Enter to create a new item row
  • Use Backspace to remove an item and move up

Multiple Answers

Choice-Based Free Subscription
Learner selects all options that are correct.

The 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.Use Random Options so learners can't learn the pattern of which positions are usually ticked.
Keyboard tips
  • Use Alt+a to select the right answer
  • Use Up and Down arrows to move across items
  • Use Enter to create a new item row
  • Use Backspace to remove an item and move up

Missing Word

Fill-in-the-Blank / Text Entry Free Subscription
Learner types the missing word or phrase into a blank.
How to Build
  1. Add Question Prompt: Write your question or incomplete sentence in the main question text box.
  2. 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 Subscription
Learner enters a numeric answer, accepted if within a configured tolerance of the correct value (e.g. 9.81 ± 0.05).

Number 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 Subscription
Learner drags each item from a pool into the category it belongs to; correct only when every item is placed in its correct category.

Examinees 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 Subscription
Use this question type to test the ability of the learner categorizing different answer options into categories with additional coloring and animation flavors.

Learner 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 Subscription
Learner drags labels onto positions marked on an image (or types an answer directly into a position); correct only when every position's label matches.
How to Build
  1. Select Image: Choose or upload the background reference image.
  2. Position Drop Zones: Place target placeholders over key locations on the image.
  3. Add Label Pool: Define the draggable text options available.
  4. 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 Subscription
Learner enters a mathematical expression, graded by symbolic equivalence rather than exact text match.
How to Build
  1. 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+1 and 1+x both 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 Subscription
Learner drags options into numbered positions embedded directly in the question text, or types an answer into each position directly.
How to Build
  1. Add Text & Placeholders: Write your question text and insert target dropzone markers like 1($), 2($), etc., directly into the text prompt.
  2. Add Option Pool: Enter the draggable options line-by-line in the Answers field (supports optional value|html format).
  3. 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 matches 2($)).
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 Subscription
Learner clicks or taps individual words within the question text to select them.
How to Build
  1. Provide Text Passage: Write the sentence or paragraph in the main question stem.
  2. 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 Subscription
Learner drags items to put them in the correct order.
This is a simple question type where you can add items in sorted orderand randomize the items by enabling Randomize 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 Subscription
Learner draws lines connecting matching items between two columns.
How to Build
  1. Define Column Items: Provide the items organized under two column headers (for example, Column 1: Countries, Column 2: Capitals)[cite: 9].
  2. 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 Subscription
Learner guesses a hidden word one letter at a time, with a limited number of wrong guesses allowed.
How to Build
  1. Set Target Word: Type the word or phrase to be guessed into the Correct Answers field.
  2. Add Formatted Display (Optional): Use value|html if 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 Subscription
Learner solves a 3x3 sliding image puzzle for engagement, then types a text answer, which is what's actually graded.
How to Build
  1. Select Puzzle Image: Upload or select an image to be sliced into the 3x3 sliding puzzle grid.
  2. 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 Subscription
Learner aims a cannon and fires at the correct option(s) among several targets.

The 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 Subscription
Game-style word-guess: learner uses letter-by-letter feedback to find the secret word within a fixed number of trials.
How to Build
  1. Write the Clue: Enter the hint in the Title or Rich Details field — this is what the learner sees.
  2. 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.
  3. 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 Subscription
Drag puzzle pieces from a pool into matching sockets. JSON answer storage avoids comma-in-text issues.
How to Build
  1. Column Titles: Set a label for the left column (draggable items) and the right column (fixed targets).
  2. Add Pairs: For each pair enter the left item text and its matching right item text. Items support plain text, LaTeX \( ... \), or HTML.
  3. 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.