> For the complete documentation index, see [llms.txt](https://synap.ac/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synap.ac/docs/platform/quizzes/builder-overview.md).

# Builder overview

Quizzes are reusable Library items for assessed or practice activities. A quiz contains questions and optional sections, plus shared rules for scoring, grading, delivery and results.

{% hint style="info" %}
**Location:** Library → Create or upload → Quiz
{% endhint %}

### Quiz builder areas

| Area             | Purpose                                                                           |
| ---------------- | --------------------------------------------------------------------------------- |
| **Quiz details** | Set the title, descriptions, owner and collaborators.                             |
| **Questions**    | Add, edit, reorder and export questions.                                          |
| **EMQ groups**   | Group related Extended Matching Questions (EMQs) around shared material.          |
| **Import**       | Create or update questions and EMQ groups from Comma-Separated Values (CSV) data. |
| **Instructions** | Add content users see before the first question.                                  |
| **Sections**     | Divide the quiz and apply section-level rules.                                    |
| **Scoring**      | Set default credit, partial credit and negative scoring.                          |
| **Grading**      | Define pass/fail behaviour and grade boundaries.                                  |
| **Experience**   | Control modes, timers, navigation, security and learner tools.                    |
| **Results**      | Decide when results are released and what users can see.                          |
| **Access**       | Grant user groups permission to view or manage the quiz.                          |

### What is inherited and what is overridden

Quiz-level values provide the normal behaviour for the item. Individual questions can override default marks and feedback, while sections can override selected timing and navigation rules. An Exam that uses the quiz as its source adds a further controlled delivery layer.

When investigating unexpected behaviour, work from the student's attempt backwards: delivery wrapper, section, question, then quiz default. The most specific applicable setting normally explains the result.

### A useful configuration order

1. Complete **Quiz details**.
2. Add or import questions and configure their answers.
3. Add instructions, EMQ groups or sections where required.
4. Set scoring and grading rules.
5. Configure the user experience and results.
6. Preview the quiz in every allowed mode.
7. Confirm access before using the quiz in a collection, course, assignment or exam.

Use **Preview** after each group of changes. Complete at least one correct, incorrect, partially correct and skipped response; check the score, grade, feedback and results disclosure rather than stopping when the player opens.

{% hint style="warning" %}
Changing shared scoring, grading or experience settings can affect every future use of the quiz. Check where a live quiz is used before making substantial changes.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://synap.ac/docs/platform/quizzes/builder-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.