Documentation

Manual Builder

The drag-and-drop quiz builder lets you add questions one by one. Supported question types include multiple choice (single or multi-select), true/false, short answer, and long-form theory questions. You can add images to questions, set point values per question, and reorder questions freely.

Importing from Files

Bulk-import questions from Markdown, CSV, TXT, or DOCX files. Each format follows a simple structure:

question,option_a,option_b,option_c,option_d,answer
"What is 2+2?","3","4","5","6","B"
"Capital of France?","Berlin","Madrid","Paris","Rome","C"

Supported formats: .md .csv .txt .docx

Importing from Google Forms / Microsoft Forms

Paste a shareable link from Google Forms or Microsoft Forms and Quizlio will automatically import the questions, options, and correct answers. After import, you can edit any question before publishing. Note: only quiz-type forms with scoring enabled are supported.

AI-Powered Quiz GenerationPro / Enterprise

Describe a topic or paste study material, and Quizlio's AI will generate relevant questions with correct answers. You can specify the number of questions, difficulty level, and question types. All AI-generated questions are editable before publishing.

Proctoring Options

Enable proctoring to monitor test integrity. When turned on, test takers must grant camera and screen access before starting. Available proctoring features include:

• Webcam recording -- continuous video capture throughout the exam session.
• Tab-switch detection -- logs when a test taker navigates away from the quiz tab, with configurable maximum allowed switches.
• Full-screen enforcement -- requires the browser to remain in full-screen mode during the exam.
• Copy/paste blocking -- disables clipboard actions within the quiz interface.

Enabling Proctoring

Open your quiz, go to Settings → Proctoring, and toggle proctoring on. You can then choose which monitoring features to activate for that specific quiz. Settings are saved per quiz — not globally.

Available Monitoring Features

Safe Exam Browser (SEB)

For high-stakes exams, Quizlio supports Safe Exam Browser (SEB) — a hardened, locked-down browser that prevents takers from accessing any other application, website, or system resource during an exam. SEB is the industry standard for computer-based testing in academic and professional settings.

When SEB mode is enabled on a quiz, only takers launching the exam through a correctly configured Safe Exam Browser can proceed. Anyone attempting to open the quiz in a standard browser will be blocked and shown instructions to download SEB.

What SEB Enforces

Enabling SEB on a Quiz

1. Go to Settings → Proctoring for your quiz.
2. Toggle Require Safe Exam Browser on.
3. Download and configure an SEB config file (.seb) from the settings panel — Quizlio generates this for you with the correct quiz URL and browser keys pre-filled.
4. Distribute the .seb file to your takers, or instruct them to download SEB from safeexambrowser.org and open the config file before the exam.
5. Optionally set a quit password so takers cannot exit SEB mid-exam without your approval.

The Taker Experience

When a taker opens a proctored quiz, they see a clear consent screen explaining exactly what will be recorded. They must explicitly agree before the quiz begins. The steps are:

Reviewing the Integrity Report

After a submission, the quiz owner can open the integrity report from the submission detail view. The report includes:

• Webcam footage — timestamped video playback of the entire exam session.
• Tab-switch log — count and timestamps for each time the taker left the quiz tab.
• Full-screen violations — timestamps for each full-screen exit event.
• Overall risk flag — a summary flag if any monitored threshold was exceeded.

Only the quiz owner who created the exam and authorized Quizlio support staff can access proctoring footage. It is never shared with third parties.

Quiz Invitations

Send targeted quiz invitations from the Invitations tab on any quiz you own. Each invitation is tied to a specific email address.

Course Invitations

Course invitations work the same way, but instead of granting quiz access, they enroll the invitee into the course. Invitees can accept directly from the invitation link without needing to navigate the platform manually.

• Open your course, go to the Invitations tab, and add invitees by name and email.
• Each invitee receives an email and (if they have a Quizlio account) a bell notification with a direct enrollment link.
• Clicking the link takes them to the course acceptance page where they can enroll with one click.
• Once enrolled, the course appears under My Courses in their dashboard.

Bulk / Group Invitations

To invite a group at once, upload a CSV file with two columns: name and email. Quizlio processes each row and sends individual invitations with personalized links.

name,email
Jane Doe,[email protected]
John Smith,[email protected]
Amara Okafor,[email protected]

Duplicate emails are ignored. If an email was previously cancelled, a fresh invitation is automatically created.

Managing Invitations

For Invitees

• Check your email for an invitation from Quizlio. The email contains a direct link — no account required to take a quiz, but an account is needed to enroll in a course.
• If you have a Quizlio account, you'll also see a bell notification. Click it to go directly to the quiz or course acceptance page.
• Accepted course invitations appear under My Courses. If you accepted but don't see a course, check there first.

Automatic MCQ Scoring

Multiple choice, true/false, and short-answer questions with exact matches are graded instantly upon submission. Scores are calculated based on the point value assigned to each question. Test takers see their results immediately if the quiz owner has enabled instant feedback.

AI Theory GradingPro / Enterprise

Long-form and theory questions can be graded by AI. The system evaluates answers against the model answer or rubric you provide, assigning a score and generating feedback. AI grades are marked as provisional until you approve or adjust them.

Manual Review & Grading

For any question type, you can manually review and override grades. The grading interface shows the question, expected answer, and the test taker's response side by side. Add written feedback to individual answers to help test takers learn from their mistakes.

Leaderboard

Each quiz has an optional leaderboard that ranks all takers by their final score in real time. Quiz owners can enable or disable it from Settings → Results.

• Live ranking — scores update on the leaderboard as soon as auto-grading completes. Manual grades appear after the owner dispatches results.
• Public or private — owners can set the leaderboard to visible to all takers, or keep it owner-only.
• Tie-breaking — takers with equal scores are ranked by submission time (earlier = higher rank).
• Anonymous mode— optionally show ranks without revealing other takers' names.

Takers on a Taker Pro plan can view their historical leaderboard positions across all quizzes they have participated in.

Dispatching Results

Once grading is complete, dispatch results to all test takers with a single click. Each taker receives an email with their score, grade breakdown, and any feedback you have added. You can also choose to withhold results and release them at a specific date and time.

Enabling Certificates

Toggle certificate issuance in your quiz settings. Set a minimum passing score (e.g., 70%) that test takers must achieve to receive a certificate. Certificates are generated automatically after results are dispatched.

Customizing Templates

Customize the certificate appearance with your organization's name, logo, colors, and a signature. Choose from built-in templates or upload a custom background image. The test taker's name, quiz title, score, and completion date are populated automatically.

Verification URLs

Every certificate includes a unique verification URL that third parties can use to confirm its authenticity. The verification page displays:

Revoking Certificates

If you discover academic dishonesty or need to invalidate a certificate for any reason, you can revoke it from your dashboard. Revoked certificates will show a "Revoked" status on the verification page. The test taker is notified via email when a certificate is revoked.

Uploading PDFs & Documents

Attach study materials to any quiz so test takers can prepare before attempting the exam. Supported file types include PDF, DOCX, PPTX, and plain text files. Each quiz supports up to 10 attachments with a maximum file size of 25 MB per file.

Adding YouTube / Vimeo Videos

Paste a YouTube or Vimeo URL to embed video content directly in the study materials section. Videos are displayed in an embedded player so test takers can watch without leaving the platform. You can add multiple videos and reorder them as needed.

Tracking Completion

When study materials are attached to a quiz, you can optionally require test takers to mark materials as "completed" before they are allowed to start the quiz. The analytics dashboard shows which takers have viewed each material and their completion status.

The Dual Role System

Every Quizlio account has two modes built in: Quiz Owner and Learner (Taker). You can switch between them at any time from the same account — no second login needed.

Free Tier

The free plan includes unlimited quiz creation with up to 50 responses per quiz, basic analytics, and manual grading. Free accounts can use all question types and basic proctoring features. Study materials and certificates are available on free plans with limited customization.

Owner Plans

Owner plans govern your quiz creation, response limits, AI features, and team capabilities. Plans are billed monthly and can be cancelled at any time:

Taker ProLearner Plan

Taker Pro is a separate subscription for learners who want to get more out of Quizlio as a study platform — independent of whether an owner has invited them to a quiz. Taker Pro includes:

• Unlimited AI flashcard generation — generate flashcard decks from any uploaded material without a credit cap.
• AI study assistant — ask questions about your study materials and get instant explanations.
• Performance analytics — detailed breakdown of your quiz history, score trends, and weak areas.
• Priority certificate delivery — certificates are issued and verified faster for Taker Pro members.
• Leaderboard visibility — appear on public leaderboards and compare scores with other takers on the same quiz.

Taker Pro can be combined with any owner plan. If you both create quizzes and take quizzes, you can hold an owner plan and Taker Pro simultaneously under one account.

One-Time Purchases

Some features are available as one-time purchases instead of recurring subscriptions. For example, you can purchase additional AI grading credits or additional response slots for a single quiz without upgrading your entire plan.

AI Feature AccessPro / Enterprise

AI-powered features including quiz generation, theory grading, and smart analytics are available on Pro and Enterprise plans. Each plan includes a monthly AI credit allocation. Additional credits can be purchased separately if needed.

Owner Analytics Dashboard

Your main dashboard provides a high-level overview of all your quizzes: total responses, average scores, completion rates, and trends over time. Identify your most popular quizzes, track growth in participation, and monitor overall performance at a glance.

Per-Quiz Analytics

Drill into individual quiz performance with detailed breakdowns:

Taker Performance Tracking

Test takers can view their own performance history from their profile: past quizzes taken, scores achieved, certificates earned, and areas for improvement. Quiz owners can also view a per-taker breakdown showing all attempts and scores for a specific participant.

Exporting Data

Export quiz results and analytics in multiple formats for external use:

Creating an API Key

1. Go to Integrations in the dashboard sidebar.
2. Click New API Key and give it a descriptive name.
3. Select the scopes you want to grant (see below).
4. Copy the key immediately — it is only shown once.

Available Scopes

Using the API

Pass your API key in the X-Api-Key header on every request.

cURLTypeScriptPython

cURL Copy

curl https://api.quizlio.app/api/v1/integrations/enterprise/analytics/ \
  -H "X-Api-Key: qzl_your_api_key_here"

Base URL: https://api.quizlio.app

Available Endpoints

Email Domain Restriction

Enterprise owners can restrict quiz access to specific email domains. Under Integrations → Allowed Domains, add your company domain (e.g. @yourcompany.com). When set, quiz invitations will only be accepted from matching email addresses, ensuring only internal users can participate.