Default question types
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 | Type | Default | Description |
|---|---|---|---|
| The question text with blanks | string | — | The text of the question (string), with blanks represented by ___ |
| Correct answer | 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. |
Matching
Match the correct items with their pairs from two lists.
ID: examplary.expansion.matching
Capabilities: AI generation, Auto-scoring
Settings:
| Setting | Type | Default | Description |
|---|---|---|---|
| Pairs | string-array | — | Array containing pairs, where each pair is a string that contains =. The text left of the = in each pair will be shown in the left column, and the rest in the right column. Example: ["Apple = Red", "Banana = Yellow"]. |
| Correct answer | string-array | — | Should exactly mirror the pairs setting. |
| 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 | boolean | false | Whether to show the options in a random order to the student. |
Sequence
Arrange items in the correct order.
ID: examplary.expansion.sequence
Capabilities: AI generation, Auto-scoring, QTI 3.0 export
Settings:
| Setting | Type | Default | Description |
|---|---|---|---|
| Options | string-array | — | The items that the student should rearrange, in the correct order. Can contain simple HTML markup. |
| Correct answer | string-array | — | Should exactly mirror options. |
Upload file
Requires student to upload a file.
ID: examplary.expansion.upload-file
Capabilities: AI generation, AI grading, QTI 3.0 export
Settings:
| Setting | Type | Default | Description |
|---|---|---|---|
| Accepted file types | */*, 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. |
Javascript
Ask the student to write a Javascript program to solve a problem.
ID: examplary.programming.javascript
Settings:
| Setting | Type | Default | Description |
|---|---|---|---|
| Assertions | string | expect(result).toEqual([1, 2, 3]); | The assertions to check the student's code against. |
| 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 | Type | Default | Description |
|---|---|---|---|
| Conversation prompt | 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 | 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 | boolean | false | — |
| Maximum number of responses | 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 | Type | Default | Description |
|---|---|---|---|
| Maximum length | 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 | Type | Default | Description |
|---|---|---|---|
| Multiple choice answer options | string-array | — | An array of option strings that represent the choices to the student. Each value can contain HTML. |
| Correct answer | 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 | 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 | Type | Default | Description |
|---|---|---|---|
| Multiple choice answer options | string-array | — | An array of option strings that represent the choices to the student. Each value can contain HTML. |
| Correct answer(s) | 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 | 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 | Type | Default | Description |
|---|---|---|---|
| Picture choice answer options | string-array | — | An array of image URL strings that represent the choices to the student. |
| Correct answer | 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 | Type | Default | Description |
|---|---|---|---|
| Correct answer | 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 | Type | Default | Description |
|---|---|---|---|
| Minimum word count | number | — | — |
| Maximum word count | number | — | — |
Formula
A question that requires a mathematical expression as response.
ID: examplary.expansion.formula
Capabilities: AI generation, AI grading
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 | Type | Default | Description |
|---|---|---|---|
| Date type | full-date, year | — | The type of date to expect (e.g. year only, full date). |
| Correct answer | 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. |