Quiz Builder - FAQ & Help

1. Switch to Teacher mode. Use the Student/Teacher toggle in the navigation bar at the top of the page. The toggle slides from the student icon to the teacher icon.
2. Locate the Quiz Builder button. On the home page, look for the pink "Quiz Builder" button. It appears in the teacher-only toolbar area.
3. Click to open "My Quizzes". This is your quiz dashboard — a list of all saved quizzes with their name, question count, date created, and status.
4. Create or import.
   • Click "+ New Quiz" to start building a fresh quiz.
   • Click "Import JSON" to load a previously exported quiz file.

When you create a new quiz, it starts with the default name "Untitled Quiz". Click the quiz name at the top of the builder to edit it. The name field is inline-editable — just click, type, and click away or press Enter.

Use descriptive names that help you identify the quiz later. Good examples:

• Chapter 5 Fractions Test
• Weekly Mixed Review - Week 12
• Geometry Unit Assessment
• Multiplication Facts Checkpoint

Questions are added from MathQuest's full skill library. There are two ways to find skills:

1 Search

Type in the search box at the top of the skill browser panel. Search matches skill names, categories, and domains. For example, typing fractions shows all fraction-related skills; typing multiply shows multiplication skills across all categories.

2 Browse

Scroll through the skill browser, which is organized hierarchically: Domain > Category > Skill. Click to expand domains and categories, then click a skill to select it.

Adding Questions from a Skill

1. Click a skill to select it (it highlights to confirm selection).
2. Set the number of questions to add using the quantity control (1–50).
3. Click "Add" to generate that many questions from the selected skill.

Each question is randomly generated using MathQuest's question engine. The skill determines the type of math problem; the specific numbers are randomized. This means every quiz you create is unique, even when using the same skills.

Once added, questions appear in the right panel as a numbered list. Each question card shows:

• Question number — Q1, Q2, Q3, etc.
• Skill label badge — A colored pill showing the skill name (e.g., Add Fractions).
• Points value — Editable. Click the points number to change it (default: 1 point per question).
• Question preview — The text of the generated question so you can review it.

Question Actions

The toolbar at the bottom shows the total question count and total points, updating live as you add, remove, or adjust point values.

Control how long students have to complete the quiz.

When enabled, the question order is shuffled per student. Every student gets the same set of questions, but in a different sequence.

• Helps prevent copying between students sitting near each other.
• The original question numbering is preserved in results for teacher analysis — you always see Q1, Q2, etc. in the same order you built them.
• Disable this if question order matters (e.g., questions build on each other, or you want to start easy and increase difficulty).

Controls what students see about their answers and when.

Set the percentage threshold that determines a Pass or Fail result. The default is 70%.

• Students see their pass/fail status on the results screen after submitting.
• The teacher results view uses this threshold to calculate the class pass rate.
• Adjust based on your expectations: 60% for challenging assessments, 80% for mastery checks.

1. Click "Share Link" in the toolbar at the bottom of the quiz builder.
2. The quiz is saved automatically if it has unsaved changes.
3. A share URL is generated and copied to your clipboard.
4. Paste the link into your preferred channel:
   • Email — Paste directly into an email to students or parents.
   • Google Classroom / Canvas / LMS — Post as a link or assignment.
   • Messaging apps — Send via Teams, Remind, WhatsApp, etc.
   • QR code — Paste the link into any QR code generator for display on a projector or handout.

When a student clicks the shared link, they land on a quiz entry page with:

1. Quiz name displayed prominently at the top.
2. Quiz details — number of questions, total points, and time limit (if set).
3. Name entry field — Students must type their name. This is required and is how results are identified.
4. "Start Test" button — Becomes active only after the student enters their name.

For backup, sharing between teachers, or when the URL is too long:

Exporting

1. Click "Export JSON" in the toolbar.
2. A .json file downloads to your computer.
3. Share the file via email attachment, Google Drive, OneDrive, USB drive, etc.

Importing

1. From the "My Quizzes" list, click "Import JSON".
2. Select the .json file from your computer.
3. The quiz loads with all questions, settings, and point values intact.

Use cases for JSON export/import:

• Sharing between teachers — Email the JSON file to a colleague who imports it on their device.
• Backup — Save quiz files to cloud storage for safekeeping.
• Large quizzes — When the share URL is too long, the JSON file works regardless of quiz size.
• Year-to-year reuse — Export at the end of the year, import next year.

The test interface is designed for focus and simplicity:

• Top bar — Shows the student's name, question progress (e.g., "Q3 of 10"), countdown timer (if timed), and count of answered questions.
• Progress bar — Visual bar showing completion percentage, filling in as questions are answered.
• One question at a time — Each question occupies the full content area. No scrolling through a long list. Students focus on one problem before moving to the next.
• Answer input — Depending on the skill, students either type their answer in a text field or select from multiple-choice options.

Students can move freely between questions:

• Previous / Next buttons — Move one question forward or back.
• Question number grid — A grid of numbered squares lets students click any question number to jump directly to it.

Question Grid Color Coding

• Flag button — Students can flag questions they want to come back to. Flagging is for the student's own reference and does not affect grading. Flagged questions show as orange in the question grid.
• Free movement — Students can go back to any question and change their answer at any time before submitting.

When the student reaches the last question and clicks "Review & Submit", a summary screen appears:

• Summary counts — Total answered, unanswered, and flagged questions.
• Question list — Every question with a status icon (answered, unanswered, flagged).
• Click to return — Click any question in the list to jump back and answer or change it.
• "Submit Test" button — Finalizes the quiz. Once submitted, answers cannot be changed.

What students see after submitting depends on the Show Feedback setting:

Score Display (All Modes)

• Score circle — A large percentage circle, colored green if the student passed or red if they did not.
• Score, percentage, and time taken are displayed.

Question Breakdown (Feedback Modes)

• "After each question" — Students already saw feedback during the test. The results screen shows the final summary.
• "After submission" — Full review of every question: the student's answer, the correct answer, and whether it was right or wrong.
• "Score only" — Only the score and percentage. No per-question details.

Download Results

After completing the quiz, students see a "Download Results" button. This saves their individual result as a JSON file. Students can give this file to the teacher for import into the results dashboard. This is useful when students take quizzes on their own devices outside of school.

There are two ways to access results for a quiz:

• From "My Quizzes" — Click the "Results" button on any quiz card in the quiz list.
• From inside the builder — While editing a quiz, click "Results" in the bottom toolbar.

Summary Cards

The results dashboard opens with four summary cards at the top:

This is one of the most valuable sections for instructional planning. Questions are grouped by skill, and the aggregate accuracy is calculated for each.

How It Works

• All questions tagged with the same skill are grouped together.
• The percentage of correct answers across all students is calculated for each skill.
• Skills are sorted from weakest to strongest.

Color Coding

Summary Box

Below the skill list, a summary box categorizes all skills into three groups:

• Strong areas — Skills where the class performed well. Reinforce and move on.
• Developing — Skills that need more practice. Consider review activities.
• Needs practice — Skills with low accuracy. Plan targeted reteaching.

A bar chart shows the percentage of students who answered each question correctly.

• Each bar represents one question (Q1, Q2, Q3, etc.).
• Bars are color-coded: green for high accuracy, orange for moderate, and red for low accuracy (below 50%).
• Hover over any bar to see the skill name for that question.

Low-scoring individual questions may indicate a confusing question phrasing rather than a skill gap. Compare per-question results with the skill-level analysis to distinguish between the two.

A table listing every student who completed the quiz:

Individual Student Detail

Click any row in the student table to expand that student's detailed breakdown:

• Every question with: the student's answer, the correct answer, and correct/incorrect status.
• Per-skill accuracy for that individual student.
• Strengths and weaknesses specific to that student — useful for individualized intervention planning.

CSV Export

Click "Export CSV" to download all results as a spreadsheet-compatible file.

CSV format:

Import the CSV into Excel, Google Sheets, or your school's gradebook system. Each Q column contains 1 (correct) or 0 (incorrect).

Import Student Results

Click "Import Results" to upload student JSON result files. This is for when students take quizzes on their own devices:

1. Students complete the quiz and click "Download Results" to save a JSON file.
2. Students submit their JSON files to you (via email, LMS file drop, Google Drive, etc.).
3. Click "Import Results" and select one or more JSON files.
4. The imported results appear in the student results table alongside any results already collected.

Click "Print" in the builder toolbar to generate a print-ready version of the quiz.

A new browser window (or tab) opens with the formatted quiz, ready for your browser's print dialog. The printed page includes:

• Quiz header — Quiz name and date, centered at the top.
• Student name line — A blank "Name: _______________" line for students to fill in.
• Numbered questions — Each question is numbered and shows its point value (e.g., "1. (2 pts)").
• Answer lines — Blank lines or multiple-choice options for students to write their answers.
• Visual questions — Any questions with visual elements (geometry, number lines, fractions, etc.) are rendered as SVG graphics in the print output.
• Answer key — A separate page at the end with the correct answer for each question, along with skill labels. Print this page separately or keep it for your records.

• 3–5 questions per skill for reliable data. One question per skill is not enough to judge mastery; a student could guess correctly or make a careless mistake. Three to five questions per skill gives you a meaningful accuracy percentage.
• Use "Regenerate" freely. If a generated question looks too easy, too hard, or ambiguous, click "Regen" to get a new version. Same skill, new numbers. No limit on regenerations.
• Mix skills thoughtfully. For a unit test, include all skills from the unit. For a weekly review, mix the current week's skills with a few from prior weeks for spaced practice.
• Adjust point values for harder questions. If some questions are significantly more challenging, give them 2 or 3 points to weight the score appropriately.

• Feedback mode:
  • Use "After each question" for practice quizzes and formative assessments. Students learn from immediate feedback.
  • Use "After submission" for formal tests. Students focus on all questions before seeing results.
  • Use "Score only" when you plan to reuse the same quiz for retakes or across classes.
• Enable random order for any in-class assessment to minimize answer-sharing.
• Time limits: Allow 1–2 minutes per question. 10-question quiz = 15–20 minutes. 20-question quiz = 30–40 minutes.

• Check Skill Strengths & Weaknesses first. This is the most actionable view. It tells you exactly which skills need reteaching and which are solid.
• Red skills = whole-class review. If most students struggle with a skill, it needs class-wide instruction, not individual remediation.
• Use individual student detail for intervention. Click into a specific student's results to see their personal strengths and weaknesses. Use this for small-group instruction or parent conferences.
• Export CSV as backup. Browser data can be lost if the browser cache is cleared. Always export a CSV copy of important assessment results.
• Import student results from JSON when students take quizzes at home. Collect the result files and bulk-import them into the teacher dashboard.

• Export quizzes as JSON to reuse across classes and school years. Build once, use many times.
• Print the answer key separately and keep it with your lesson plans. Useful for hand-grading printed versions.
• Combine online and printed versions. Some students can take the quiz online while others use the printed version. Import all results into the same results view.
• Create follow-up quizzes from weak skills. After reviewing results, build a new quiz focused only on the skills marked "Needs Practice."

"Quiz too large for URL"

Very large quizzes (50+ questions, especially with visual elements like geometry or number lines) can produce share URLs that exceed browser or email length limits. URLs are typically safe up to about 2,000 characters, but some quiz URLs may be longer.

Solution: Export the quiz as a JSON file instead. Click "Export JSON" in the toolbar and share the file directly. The recipient can import it on their end.

Questions don't show visuals

Some questions include visual elements (SVG diagrams, number lines, geometric shapes, fraction models). These visuals require the full MathQuest app to render properly.

Solution: Visual questions display correctly in the online quiz and in printed versions (which include SVG graphics). If you are viewing raw quiz data (e.g., in the JSON file), visuals won't be present — they are generated at render time.

Results disappeared

Quiz results are stored in your browser's IndexedDB, which is a local database on your computer. If you clear your browser data (cache, cookies, site data), the results are deleted.

Solution: Always export CSV or JSON copies of important results as backup. Results in exported files are not affected by browser data clearing. If you use multiple browsers or devices, results are per-browser.

Student can't open the link

The most common cause is URL truncation. Some email clients or messaging apps cut off long URLs.

Solutions:

• Verify the full URL was copied (open it yourself first to test).
• Use a link shortener (bit.ly, tinyurl.com) to create a shorter URL.
• Post the link as a clickable hyperlink rather than plain text.
• If using Google Classroom or an LMS, the link should paste without truncation.

Timer ran out

When a timed quiz's countdown reaches zero, the quiz auto-submits immediately with whatever answers the student has entered. Any unanswered questions are scored as incorrect.

Advice: Set time limits generously. It is better to have students finish early than to have the timer cut them off. If many students run out of time, consider increasing the limit or reducing the question count for future quizzes.

Quiz won't save

Quizzes are saved to IndexedDB. If your browser's storage is full or IndexedDB is disabled (rare), saving may fail.

Solutions:

• Check that you are not in a private/incognito browser window (some browsers limit IndexedDB in incognito mode).
• Clear old browser data to free up storage space.
• Try a different browser (Chrome, Edge, Firefox all support IndexedDB).
• Use "Export JSON" as a manual save — the file can always be re-imported.