> For the complete documentation index, see [llms.txt](https://academy.synap.ac/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.synap.ac/doc/quizzes/creating-a-quiz/question-types/advanced-question-types.md).

# Advanced question types

Get in touch with support about early access

{% hint style="info" %}
Not all of question types are enabled by default if you're interested in having them enabled early please get in touch with support&#x20;
{% endhint %}

<table><thead><tr><th width="155.3021240234375">Question Type</th><th width="166.2603759765625">Category</th><th>Description</th></tr></thead><tbody><tr><td><strong>Choice matrix</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Answers a grid of statements, choosing one option for each row (e.g. true/false, or which category applies).</td></tr><tr><td><strong>Numeric answer</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Types a number, checked against correct answer / range</td></tr><tr><td><strong>Text selection</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Clicks the correct words or phrases in a passage. You set which parts of the text are selectable and which are correct.</td></tr><tr><td><strong>Matching</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Matches each item in one list to its pair in another.</td></tr><tr><td><strong>Classification</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Sorts items into the correct categories.</td></tr><tr><td><strong>Bow tie</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Completes a bow-tie diagram: the condition in the centre, with the right actions and parameters on either side.</td></tr><tr><td><strong>Image labelling: Drag &#x26; drop</strong></td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Drags labels onto the correct places on an image.</td></tr><tr><td><strong>Image labelling: Dropdown</strong> </td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Chooses each label on an image from a drop-down list.</td></tr><tr><td><strong>Image labelling: Text</strong> </td><td><mark style="background-color:blue;">Auto marked</mark></td><td>Types each label on an image.</td></tr><tr><td><strong>Coding</strong></td><td><mark style="background-color:green;">Manually marked</mark></td><td>Writes code in a code editor.</td></tr><tr><td><strong>Drawing</strong></td><td><mark style="background-color:green;">Manually marked</mark></td><td>Draws or annotates an answer on a canvas, e.g. a diagram or sketch.</td></tr><tr><td><strong>Likert</strong></td><td><mark style="background-color:$secondary;">Not marked</mark></td><td>Rates agreement or opinion on a scale (e.g. Strongly disagree to Strongly agree).</td></tr><tr><td><strong>Off platform</strong></td><td><mark style="background-color:green;">Manually marked</mark></td><td>Completes a task away from the platform, such as a practical or observed assessment. A marker records the result.</td></tr></tbody></table>

### Choice matrix

Candidates see a grid with statements in the rows and answer options in the columns, and choose one option for each row. It tests several related judgements in a single question, without a separate multiple choice question for each statement.

**Example***:* For each statement, choose whether it applies to Option A or Option B.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fh3PL0s0DGge3eGrZPVyg%2FScreenshot%202026-11-17%20at%2012.44.15.png?alt=media&amp;token=3fb56b37-6d56-4a5b-a18e-7f882d4e5249" alt=""><figcaption></figcaption></figure>

### Numeric answer

Candidates type a number as their answer, which is marked against the correct value you set. Use it wherever the answer is a calculated or measured figure, rather than giving candidates options to choose from.

**Example***:* Calculate the value from the figures given and enter your answer.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fr1wOCuBNufs34jujG3l0%2FScreenshot%202026-11-17%20at%2012.45.17.png?alt=media&amp;token=82deea9d-99ed-4c7f-a6bb-191e73382baa" alt=""><figcaption></figcaption></figure>

### Text selection

Candidates read a passage and click the words or phrases that answer the question. You choose which parts of the text can be selected and which are correct, and can control how many selections are allowed.&#x20;

**Example**: Select all from the text that meet the definition given

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FRx4CRPvV9f86SqNAuvNI%2FtextSelection.gif?alt=media&amp;token=01f580eb-68b4-4092-b553-8f45deca4010" alt=""><figcaption></figcaption></figure>

### Matching

Candidates match each item in one list to its pair in a second list. It’s a quick way to test knowledge of relationships, such as terms and definitions or causes and effects.

**Example***:* Match each term to its correct definition.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F7T0VLow44EqsvTvn4wl7%2FScreenshot%202026-11-17%20at%2012.46.10.png?alt=media&amp;token=ea10770f-ba09-463a-80b2-ff0a09264c92" alt=""><figcaption></figcaption></figure>

### Classification

Candidates sort a set of items into categories you define. It tests whether candidates understand how things are grouped and can tell similar concepts apart.

**Example***:* Sort each item into the category it belongs to.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FWXMiBBwgiBPfFqS8YvJs%2FScreenshot%202026-11-17%20at%2012.58.13.png?alt=media&amp;token=9328fe23-df26-48a7-adc7-9a57aa55ee1b" alt=""><figcaption></figcaption></figure>

### Bow tie

Candidates complete a bow-tie diagram. They identify the central issue, then the actions to take on one side and the factors to monitor on the other. It’s built for clinical judgement and other scenario-based decisions where candidates have to connect a situation to a response.

**Example***:* From the scenario, identify the main issue, the actions to take and the factors to monitor. (Typically used for nursing/medical exams)

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F6vA5BdcBOizk5dx57VAj%2FScreenshot%202026-11-17%20at%2013.03.13.png?alt=media&amp;token=18a332bd-052e-4767-99ab-af81f4e401ea" alt=""><figcaption></figcaption></figure>

### Image labelling (any)&#x20;

Candidates label marked points on an image, such as a diagram, map or photo. There are three versions, depending on how much support you want to give:

* **Drag and drop:** candidates drag labels from a list onto the correct places. Use this to test placement rather than recall.
* **Dropdown:** candidates choose the label for each point from a drop-down list. This works well for images with lots of label points.
* **Text:** candidates type each label themselves. This is the hardest version, because they have to recall every answer.

**Example***:* Label each marked part of the image correctly.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FwqxWB1Ycz3gWdUOwUsGW%2FScreenshot%202026-11-17%20at%2013.09.33.png?alt=media&amp;token=00c124f3-9384-4c58-a182-f10903bb8038" alt=""><figcaption><p>Image labelling with drag and drop</p></figcaption></figure>

### Drawing

**Drawing** *(Manually marked)*\
Candidates draw or annotate their answer on a canvas. Use it when the answer is visual and can’t easily be typed or selected. Background images can be used.&#x20;

**Example***:* Draw a diagram showing the process described.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FnRsDxyS8QDnVQfXXlvhP%2Fdrawing.gif?alt=media&amp;token=6546a38b-99eb-4b02-8c44-cee015e2a06a" alt=""><figcaption></figcaption></figure>

### Coding

Candidates write code in a built-in code editor. It assesses programming ability in a realistic setting rather than through multiple choice questions about code. Choose from different languages on each question.

**Example***:* Write a function that solves the problem described.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F7i2hMbpObsT3EQEzYiWH%2FScreenshot%202026-11-17%20at%2013.16.27.png?alt=media&amp;token=38689544-f7c7-4d3b-b7f3-1cc352edf1d4" alt=""><figcaption></figcaption></figure>

### Data capture

Candidates rate their agreement or opinion on a scale, such as Strongly disagree to Strongly agree. The responses aren’t scored, which makes Likert suitable for gathering feedback or confidence ratings alongside assessment questions.

**Example***:* Rate how strongly you agree with each statement.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FqsXTEWasxp4wI9vzjTJo%2FScreenshot%202026-11-17%20at%2013.19.00.png?alt=media&amp;token=a4600d66-2932-4e8e-b496-35a8e67d9e7a" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.synap.ac/doc/quizzes/creating-a-quiz/question-types/advanced-question-types.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
