Examplary ships with a set of built-in question types that are available to all organisations. This page provides an overview of each default question type, its capabilities, and configurable settings.
This page is auto-generated from the Examplary API.
Introduction
Text shown to the student at the start of the test.
ID: exam-intro
Capabilities: AI generation
Paragraph
Some text to provide context or instructions to the student.
ID: paragraph
Capabilities: AI generation, QTI 3.0 export
Outro
Final text shown to the student after the test.
ID: exam-outro
Capabilities: AI generation
Fill in the blanks
Requires student to fill in one or more blanks with a short text answer. Also known as 'cloze' questions.
ID: examplary.expansion.fill-in-blank
Capabilities: AI generation, Auto-scoring
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| The question text with blanks | text | string | — | The text of the question (string), with blanks represented by ___ |
| Correct answer | correctAnswer | string-array | — | The correct answer(s) to the question, that represent the blanks. There needs to be the same number of entries as there are blanks in the text. |
| Ignore spaces and capitals | exactValuesCaseInsensitive | boolean | false | Leading/trailing whitespace is always ignored when comparing the student's answer to the correct answer. When this is enabled, letter casing is ignored too. |
Matching
Match the correct items with their pairs from two lists.
ID: examplary.expansion.matching
Capabilities: AI generation, Auto-scoring
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Left items | left | string-array | — | Array containing the items shown in the left column (or top row). Example: ["Apple", "Banana"]. |
| Right items | right | string-array | — | Array containing the answer options the student can match with, shown in the right column (or bottom row). Example: ["Red", "Yellow"]. |
| Correct answer | correctAnswer | string-array | — | Array containing the correct pairs, where each pair is a string that contains =. The text left of the = must exactly match an item from left, the text right of it an item from right. Example: ["Apple = Red", "Banana = Yellow"]. |
| Layout | layout | vertical, horizontal | vertical | The layout to use for displaying the matching question. vertical displays the items in two vertical columns, while horizontal displays them in two horizontal rows. Don't use horizontal if there are more than 3 items. |
| Shuffle options | shuffle | boolean | false | Whether to show the options in a random order to the student during digital assessments. If disabled, the options in both columns are shown in alphabetical order. Printed sheets always show the items in the order of the settings. |
Sentence analysis
Let students split a Dutch sentence into sentence parts, label each part, and mark the finite verb.
ID: examplary.expansion.sentence-analysis
Capabilities: AI generation, AI grading, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Sentence | sentence | string | — | The single Dutch sentence the student should analyse. |
| Enabled labels | enabledLabels | string-array | OW,WG,LV,BWB | Array of zinsdeel codes the student may choose from. Use only OW, WG, NG, LV, MV, VV, BWB, BVB, DB, VW. |
| Mark finite verb | requirePersoonsvorm | boolean | true | Whether the student must underline the persoonsvorm. |
| Model answer | correctAnswer | string | — | SentenceParse JSON containing tokens, ordered gapless segments, labels, and persoonsvorm. This field is hidden from the student-facing front-end. |
Sequence
Arrange items in the correct order.
ID: examplary.expansion.sequence
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Options | options | string-array | — | The items that the student should rearrange, in the correct order. Can contain simple HTML markup. |
Upload file
Requires student to upload a file.
ID: examplary.expansion.upload-file
Capabilities: AI generation, AI grading, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Accepted file types | acceptFileTypes | */*, application/pdf, .doc,.docx,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/* | */* | The types of files that students are allowed to upload. Should be one of the enum values specified below. |
Voice recorder
Ask the student to record a spoken answer.
ID: examplary.expansion.voice-recorder
Capabilities: AI generation
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Maximum recording length | maxDurationSeconds | number | 300 | Maximum recording length in seconds. |
Javascript
Ask the student to write a Javascript program to solve a problem.
ID: examplary.programming.javascript
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Assertions | assertions | string | expect(result).toEqual([1, 2, 3]); | The assertions to check the student's code against. |
| Initial value | initial-value | string | const result = ""; | The initial value to use for the code execution. |
Knowledge chat
Let the AI bot chat with the student to assess their knowledge.
ID: conversational
Capabilities: AI generation, AI grading, AI-powered
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Conversation prompt | conversationalPrompt | string | — | The prompt for the conversational question. This instructs the AI conversation partner how to converse with the student and what role the AI should play. Leave empty for non-conversational questions. |
| Completion criteria | conversationalCompletionCriteria | string | — | The completion criteria for the conversational question. This instructs the AI lector when to stop the conversation. Leave empty for non-conversational questions. Use HTML <ul> and <li> to format. |
| AI starts conversation | aiStarts | boolean | false | — |
| Maximum number of responses | maxTurns | number | 10 | — |
Short answer
A question that requires a short text response.
ID: single-line-text
Capabilities: AI generation, AI grading, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Maximum length | maxLength | number | — | The maximum number of characters allowed in the answer - optional. Don't include unless relevant. |
Long answer
A question that requires a multi-line text response.
ID: multi-line-text
Capabilities: AI generation, AI grading, QTI 3.0 export
Multiple choice
A question where students select one correct answer from multiple options.
ID: multiple-choice-single-answer
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Multiple choice answer options | options | string-array | — | An array of option strings that represent the choices to the student. Each value can contain HTML. |
| Correct answer | correctAnswer | string | — | The string of the correct answer value, matching the value field of the options. Needs to be an exact match to one of the options, including punctuation and capitalisation! |
| Shuffle answer options | shuffleAnswers | boolean | false | Whether to show the answer options in random order each time. |
Checkboxes
A question where students can select multiple correct answers from the available options.
ID: multiple-choice-multiple-answers
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Multiple choice answer options | options | string-array | — | An array of option strings that represent the choices to the student. Each value can contain HTML. |
| Correct answer(s) | correctAnswer | string-array | — | An array of strings of the correct answer values, matching the value field of the options. There can be multiple correct answers. Needs to be an exact match to one or more of the options, including punctuation and capitalisation! |
| Shuffle answer options | shuffleAnswers | boolean | false | Whether to show the answer options in random order each time. |
Picture choice
Students select one of a set of images as the correct answer.
ID: picture-choice
Capabilities: Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Picture choice answer options | options | string-array | — | An array of image URL strings that represent the choices to the student. |
| Correct answer | correctAnswer | string | — | The string of the correct answer value, matching the value field of the options. Needs to be an exact match to one of the options. |
True/false
A question that requires students to choose between true or false.
ID: true-false
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Correct answer | correctAnswer | true, false | — | The correct answer to the question, either 'true' or 'false' (as a JSON string!). |
Essay
Prompt the student to write a long answer, often using headings and text formatting.
ID: essay
Capabilities: AI generation, AI grading, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Minimum word count | minWords | number | — | — |
| Maximum word count | maxWords | number | — | — |
Formula
A question that requires a mathematical expression as response.
ID: examplary.expansion.formula
Capabilities: AI generation, AI grading
Math notebook
A question where students show their work across multiple lines of math, with the final line as the answer.
ID: examplary.expansion.math-notebook
Capabilities: AI generation, AI grading
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Initial number of lines | initialLines | number | 4 | — |
Date or year
Ask the student to enter a year (e.g. 1925).
ID: date-year
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| Date type | dateType | full-date, year | — | The type of date to expect (e.g. year only, full date). |
| Correct answer | correctAnswer | string | — | The correct answer to the question, which can be a year (e.g. 1925) or a full date (e.g. 1925-12-31), based on the dateType setting. |