> 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/results.md).

# Results

Results settings decide when an outcome becomes available and which evidence users can review.

{% hint style="info" %}
**Location:** Library → Quiz → Results
{% endhint %}

### Release results

| Option                          | Behaviour                                                                                     |
| ------------------------------- | --------------------------------------------------------------------------------------------- |
| **Automatically when possible** | Releases an automatically markable result, while attempts needing review can remain deferred. |
| **Always automatically**        | Releases results without waiting for a manual release step.                                   |
| **Always manually**             | Holds results until an authorised user releases them.                                         |

A message can be shown while results are deferred.

Choose the policy by working backwards from the least automatable question. A quiz containing an essay or file response may need staff review even when most questions mark themselves. **Always automatically** can release an incomplete-looking outcome before that work is done.

### Results page configuration

| Group                  | Options                                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| **Individual metrics** | Score, time spent and grade.                                                                        |
| **Section breakdown**  | Show or hide sections, section grades and section scores.                                           |
| **Question breakdown** | Control whether users can review stems, options, feedback, correct responses, tags and identifiers. |
| **Cohort source**      | Compare against the quiz only or its source quiz where applicable.                                  |
| **Cohort metrics**     | Cohort average, percentile and score distribution.                                                  |
| **Tag metrics**        | Tag breakdown, progress over time and the facets included.                                          |
| **Educator access**    | Allow educators to view the full administrative results page.                                       |
| **Custom messages**    | Rich-text content shown when an attempt is completed, with Variables and Logic where enabled.       |
| **Display**            | Hide the title and choose the results font size.                                                    |

![The Quiz results page showing release options and the start of results-page configuration](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWXE6hvHQFtER1a1Dm3l5%2Fuploads%2FTcYNzSQNkNn0GNZW6ld2%2Fquiz-results.png?alt=media\&token=b4b41313-1dde-4ce8-a5b5-0e380e7f4f97)

### Decide how much to disclose

For formative practice, showing the response, correct answer and feedback can make the result a learning activity. For a reusable or high-stakes question bank, the same settings can expose answer content to the first cohort. Score and grade visibility can be enabled without showing individual questions.

Cohort comparisons need an understandable comparison group. A percentile based on a small or mixed population may look precise without being useful. Only show cohort and tag metrics that students can interpret fairly.

Use a deferred-results message to set an expectation: explain that marking is in progress, when the result is likely to be available and where the student should seek help. Avoid promising a time your operational workflow cannot meet.

{% hint style="warning" %}
For high-stakes assessments, review question-breakdown settings carefully. Showing correct options or feedback can disclose assessment content after the first attempt.
{% 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/results.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.