Quiz Plugin

The Quiz plugin lets you build quizzes with scoring, correct answers, and a passing score. It's a separate plugin with its own editor and its own widget — but under the hood it uses the same field engine as Forms, so questions behave like regular form fields with extra settings for correct answers and scoring.

When to use this

• You want to test knowledge with right/wrong questions
• Users should get feedback after a question or after the whole quiz
• You need a passing score and want to send users down different paths based on their result
• You want to list previous results for a user

How it works

A quiz is similar to a form: it has field groups (pages) and fields (questions). The difference is that each single-choice question can be marked as scored with a correct answer set. When a user takes the quiz, answers are evaluated against the correct values and a score is calculated.

A quiz can be graded (pass/fail based on a passing score) or just collect answers and show a result without a pass/fail decision.

To present the quiz to the user, you add the Quiz widget to a page.

TIP

Quiz is its own plugin but shares the field engine with Forms. That means you can use the same field types — text, choice, date, numeric, image — but the quiz is stored and managed separately from regular forms.

Enable Quiz

1. Open your applet.
2. Go to Plugin Settings.
3. Turn on the Quiz plugin.
4. Save.

Create a quiz

1. Enable the Quiz plugin in the applet.
2. Open the plugin's dashboard from the side menu.
3. Click Create new quiz (or equivalent).
4. Enter a name and description.
5. Configure Result, Confirmation, Empty state, and Advanced (see below).
6. Add field groups (pages) and questions.
7. Save.

Quiz properties

The properties control the quiz's metadata, how the result is judged, and what the user sees after finishing.

Basic info

Setting	Description
Name	The quiz's name. Shown in lists and in the widget dropdown.
Description	Internal description of the quiz.
Created	Date the quiz was created. Read-only.

Result

Setting	Description
Enable limit for passed result	Turns on graded mode. When on, the user's result is judged against a passing score.
Passing score	Percentage (0–100) required for a pass. Only shown when graded mode is on.

WARNING

You cannot change graded mode or the passing score after the quiz has its first response. Decide the grading before you publish.

Confirmation

The texts shown on the result page after the user submits the quiz.

Setting	Description
Confirmation header for pass	Header shown for a passing result (or always, if the quiz isn't graded).
Confirmation text for pass	Body text below the header for a pass.
Confirmation header for fail	Header for a fail. Only shown for graded quizzes.
Confirmation text for fail	Body text for a fail. Only shown for graded quizzes.

Empty state

Shown before the user starts the quiz.

Setting	Description
Header	Header shown before the quiz starts.
Text	Body text under the header.
Button label	Label on the start button.

Style

Setting	Description
Icon	Icon representing the quiz in lists and widgets.

Advanced

Setting	Description
Anonymous quiz	When on, no responses are tied to the user. Cannot be changed after the quiz has responses.

Questions and correct answers

Questions are added in the same editor as form fields. Click Add field in a field group and pick a field type.

Field types for questions

The quiz supports the same field types as Forms — text, multi-line text, email, URL, numeric, date, date/time, file, signature, single choice, multiple choice, image, and info text. Only single choice can be scored against a correct answer — other field types collect responses without counting toward the score.

Mark the correct answer

For single choice fields:

1. Add the alternatives under Alternatives → Add alternative.
2. Tick the checkbox next to the correct alternative under Mark the correct answer.
3. Pick a Comparator type:
   • Equals — the user's answer must match the marked alternative exactly.
   • Any of — the user's answer counts as correct if it matches any of several marked alternatives.
4. Turn on Scored field under Settings so the question counts toward the total score.

Field settings

Setting	Description
Scored field	Does the question count toward the score? Only available for single choice.
Required field	The user must answer to continue.
List field	Show the field in lists of quiz results.
Searchable field	Make the field searchable across results.
Allow edit	Allow the answer to be changed after submission. Only for non-scored fields.

TIP

Use Info text and Image fields as section headers or explanatory content between questions — they don't count as answers and only act as visual support.

Show the quiz in the app

To let users take the quiz, you need to add the Quiz widget to a page in the applet. See Quiz Widget for the widget's settings.

Example

Scenario: You want to build a web knowledge test where the user must score at least 70% to pass, with feedback after each question.

1. Enable the Quiz plugin.
2. Create the Web knowledge quiz — turn on Enable limit for passed result and set Passing score to 70.
3. Write confirmation texts for both pass and fail.
4. Add a field group HTML with three single-choice questions — mark the correct answer and turn on Scored field for each.
5. Add a field group CSS with three single-choice questions.
6. Add a Quiz widget to the Test page, select the quiz, and turn on Correct each page.
7. Set Redirect to = Diploma page and Redirect to on failed result = Review page.

The user gets feedback per question, lands on the diploma page if they pass, and on the review page if they fail.

Tips

TIP

Turn on Anonymous quiz for surveys and self-assessments where you want users to answer freely without their result being tied to their account.

TIP

Put hard questions last. Then Correct each page + Disallow incorrect answers gives a good learning curve — the user builds confidence on easier questions first.

Common mistakes

WARNING

Only single choice fields can be marked as Scored field. Multiple choice, text, and numeric fields don't count toward the score — use single choice for anything that should be graded.

WARNING

Enable limit for passed result and Anonymous quiz are locked once the quiz has its first response. Decide both before publishing.

WARNING

If no question is marked as Scored field, the total score will always be 0% and every user will fail a graded quiz.