Quizzes: Overview

Quizzes are interactive assessments that present questions to participants and score their responses automatically. Unlike forms, which collect unstructured input, quizzes evaluate answers against correct options or expected values and produce a final score.

A quiz can be used for knowledge checks, training assessments, certification tests, or interactive learning modules. Each quiz has its own public URL and can be shared with participants through a link.

The quiz builder is the visual editor for assembling questions into a structured quiz. It works similarly to the form builder, but instead of adding fields you add questions, each with a specific question type and scoring configuration.

Quizzes follow the same hierarchy as forms: Quiz > Pages > Sections > Questions.

• Quiz: The top-level container. Has a title, slug, status, visibility, and access mode.
• Page: A step in a multi-page quiz. New quizzes start with one page.
• Section: A group of questions within a page. New quizzes start with one section in the default page.
• Question: An individual scored item (MCQ, True/False, short answer, etc.).

Each question carries a point value. The participant's total score is calculated as a percentage:

• Points per question: Every question is assigned a point value when created. Correct answers award the full points; partially correct answers may award proportional credit depending on question type.
• Total score: Expressed as a percentage of the maximum achievable points: (earned points / max points) * 100.

Scoring behavior varies by question type. See the Question Types page for details on how each type handles credit.

Every quiz has a lifecycle status that controls availability:

• draft: The default status. The quiz is not accessible publicly and can be edited freely.
• published: The quiz is live and accessible at its public URL.
• archived: The quiz is taken offline but retained for historical data and reporting.

Quizzes share the same visibility and access controls as forms:

• visibility: private (default), public, or unlisted
• access_mode: anonymous (default), authenticated, or optional

A quiz must be published and public (or unlisted) for its public URL to be accessible without authentication.

Every quiz has a public URL in the format {org_slug}/q/{quiz_slug}. The quiz_slug is auto-generated from the title if not specified explicitly.

This URL is included in the response of quiz list, get, create, and update operations.