> 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/exams/mark-score-attempts.md).

# Mark/Score attempts

Learn how to assign markers to attempts and view the marking modal as an admin

If you're and admin or exam creator and haven't already please see our guide below on how to set up marking for an exam and the different configurations and roles and options.&#x20;

{% content-ref url="/pages/wmffX5g1pQX91jUEJ3nY" %}
[Marking](/docs/exams/create-and-manage-exams/marking.md)
{% endcontent-ref %}

{% embed url="<https://youtu.be/RyPT4x1sCiw>" %}

Question types such as free text, file upload or audio/video recording questions require manual marking before the scores can be finalised. When creating these question types you have the option to have a custom credit value and add a rubric / mark scheme to them to guide markers on where to award marks. Once an attempt has been submitted depending on the results configuration, the results may not be released automatically to users as there are questions that require marking. This doc will walk you through the steps to finding and marking attempts&#x20;

{% content-ref url="/pages/uweQ9G8PGBl5gp7XA77k" %}
[Adding custom marks and a rubric to questions](/docs/exams/create-and-manage-exams/marking/adding-custom-marks-and-a-rubric-to-questions.md)
{% endcontent-ref %}

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FbAdLxYia7hV6q5MmJcLr%2Fmarkinginfo.gif?alt=media&amp;token=07636a3b-6828-40f0-a5e1-a1f955390d90" alt=""><figcaption></figcaption></figure>

### Marking roles

Marking / scoring on Synap is split into 3 distinct roles, if double marking is not enabled on an exam then there will only be the Moderating and Finalising makers. Please note in order to mark as an admin you will need to self assign and become the Moderating marker for an attempt.

| Term                                                                                                                                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Provisional marker</strong></p><p><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fi2v6BuC3h8FilNRk7zB8%2Fimage.png?alt=media&amp;token=d05935d7-c7c3-4fd1-89bd-f02b96494a0c" alt=""><br></p>                                                                                                         | Markers responsible for assessing attempts initially. Their marks and other inputs are not final and require validation by Moderating Markers or the system. If their marks align within an agreement threshold, they may be accepted automatically. If they cannot mark a response they can escalate it when escalation marking is enabled.                                                                                                                                                                                                                                                                                                                                                                   |
| <p><strong>Moderating marker</strong><br><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FZXNf6hKLsoffzamQsTyT%2Fimage.png?alt=media&amp;token=16bc1632-43f3-4375-a4d6-732f83bef48f" alt="" data-size="original"></p>                                                                                            | Markers who review Initial Markers' assessments and determine the final marks for an attempt. They can adjust or confirm initial assessments before an attempt is finalised. If Provisional markers are not being used (standard plans / no double marking) then the Moderating marker acts as the Initial marker as well. They can be configured to escalate responses when escalation marking is enabled                                                                                                                                                                                                                                                                                                     |
| <p>Advanced Roles : <strong>Escalation, Bakcreader, Auditing markers</strong> </p><div><figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FNJ7SFdAIaFheytbJGAZL%2FFrame%201%20(2).png?alt=media&amp;token=d45161cd-b3e3-4e45-8bc4-d9804aa0e3d3" alt="" width="375"><figcaption></figcaption></figure></div> | <p></p><p>Escalation markers handle cases where provisional or moderating markers are unable to assess an attempt due to specific customisable reasons. They can either:</p><ul><li>Accept the escalation and finalise the marks themselves.</li><li>Reject the escalation, returning it to the normal marking workflow.</li></ul><p>Backreader is the highest level of moderation. They can override marks set in the moderation step or the system, making them the final authority on an attempt’s scores.</p><p></p><p></p><p>Auditing markers conduct internal reviews after marks have been finalised. They cannot modify marks but can provide feedback, commentary, or quality assurance insights.</p> |
| <p><strong>Finalising marker</strong><br><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F8Itru92eWht4XNfrikcP%2Fimage.png?alt=media&amp;token=cf35759c-5101-425c-a2fb-cb64dd9d667a" alt=""></p>                                                                                                                 | The finalising marker is responsible for finalising the marks on an attempt, making it ready for release. This role can be assigned to an admin, educator, or manager and is configurable via global or specific permissions for an exam. The finalising marker ensures that all marks are thoroughly reviewed and validated before release.                                                                                                                                                                                                                                                                                                                                                                   |

## Marker management

The attempt management table on exams gives an overview of all attempts and the marking information and status. Attempts in any state can be assigned markers, but only attempts with a marking status 'Unmarked' can start to be marked. Use the manage columns and filtering features to assist with your marking process.&#x20;

Admins can view the marking page via the view button.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F45w0AX2BdBG366IqOQ9s%2FScreenshot%202026-09-15%20at%2016.39.34.png?alt=media&amp;token=b4aeff68-1251-42e5-ad27-e71e0ccb8901" alt=""><figcaption></figcaption></figure>

There are several marking states an attempt can be in:&#x20;

| State       | Description                                                                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Unmarked    | Attempt has been submitted, is ready for marking. In double marking this state means it can be marked by the provisionals.                              |
| In progress | Attempt has had some marks inputted, but has not been set as completed                                                                                  |
| Completed   | Attempt has been marked, and a marker has manually set this attempt's marks to completed - changes to marks can still be made if Marks is in this state |
| Finalised   | Marks on this attempt have now been finalised by a marker, no further changes can be made - the student is not yet aware of their marks                 |
| Released    | A marker has released the marks for the attempt to the student & they have been notified                                                                |

Attempts must be marked individually but you can  bulk complete, finalise and release results using the select all checkbox in the top left of the user table.

### Assigning markers

Select the attempt/s to assign markers to, use the assign markers button to open the marker management modal.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FTmuEjQqqeGWy8IX17FtA%2FScreenshot%202026-09-15%20at%2016.37.17.png?alt=media&amp;token=826c2e44-2232-4c65-89b1-29ade69b0da7" alt=""><figcaption></figcaption></figure>

The assign markers modal lets you see who's currently assigned by role as well as an overview of all markers, and add or remove markers from the attempt/s.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FLXQo2QfurXVIjCdLmg0g%2Fassignmarker2.gif?alt=media&amp;token=a014acd4-67ec-4cc9-a5f8-5f23ee7a304a" alt=""><figcaption></figcaption></figure>

## Markers inbox

For users who are only of user type 'Marker' they will have access to the Marker inbox, which is a dedicated page to view the attempts assigned to them which are ready for marking. Markers can search for attempts by id or exam name, and by default the inbox is ordered by attempt submission, showing the longest waiting first.  This page can be enabled for admins, managers and educators via the portal page settings&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FATWgrfn4ksA1oBjvcMjt%2FmarkersInbox2.gif?alt=media&amp;token=d03aceb8-7ee2-450e-888b-fca41e3a0ba9" alt=""><figcaption><p>Navigating the Markers inbox</p></figcaption></figure>

#### Candidate and question marking

> Note: **Question marking is still grouped by the attempt assigned to markers, and they will still need to submit a full set of marks for all questions in all attempts assigned to them.**

From the Markers inbox, markers have the choice to toggle between marking by candidate attempt or question.

| Type              | Description                                                                                                                                                                                                                                                                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Candidate marking | All questions the candidate had for a particular exam attempt. Markers will be able to see every question including those that are auto marked by the system for candidate attempts assigned to them                                                                                                                                                     |
| Question marking  | Marking by specific questions across candidate attempts that are assigned to the marker. The entire attempt still needs to be assigned to a marker, but they can mark the same question across multiple attempts together. Is only available for question types that have not been skipped and require marking (Free text, Audio recording, File upload) |

#### Question based marking

Toggling to Question marking shows markers the questions in attempts they've been assigned&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FJf4WLXv9g8vqEyeSV518%2FScreenshot%202024-09-17%20at%2012.27.22.png?alt=media&amp;token=a726e38e-1e14-409f-9403-34fc2d9d7a65" alt=""><figcaption><p>Toggling to Question marking</p></figcaption></figure>

From here markers can filter by question type, and see how many responses they'll be marking within the marking modal

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FHlf4QcD7Oeq7Y7m4G3OH%2FScreenshot%202024-09-17%20at%2013.07.34.png?alt=media&amp;token=5509a1e1-d1d0-4035-ad43-249499cb04a3" alt=""><figcaption><p>Filtering by question type</p></figcaption></figure>

When marking by questions once all the questions have been marked, markers will need to go back to candidate marking to submit their marks once all questions within an attempt have been marked.

## Marking page

When marking an attempt you'll be navigated to the marking modal, you'll see questions eligible for marking noted with a blue dot. From here markers can award credits, and leave feedback comments for users to view in the question feedback. Columns can be expanded or collapsed using the chevrons to help with navigation.&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F1MCmBnJFuTE8Jt1JaiN1%2Fmarkingcollapse.gif?alt=media&amp;token=d3fc2592-3046-4e1b-bc76-1547ec57f7bf" alt=""><figcaption></figcaption></figure>

From the marking page, all responses that require marking will show as blue with an unmarked status which will update marking once inputs have been started then marked once completed. Once all of the blue status's are gone all the required questions for marking are completed.&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F7pg0h5uIKfObZ0vYVwQv%2FScreenshot%202024-06-12%20at%2011.19.01.png?alt=media&amp;token=c92406cb-2590-4303-bcbd-298d97f4fb5c" alt=""><figcaption><p>Marking status</p></figcaption></figure>

* **Points** - Are what is awarded for a correct / partially correct response. If negative marking is being used then points are what are deducted for an incorrect answer
* **Credits** - The maximum points up for grabs for answering a question correctly

The feedback box contains a rich text editor, so you can leave links, photos, tables, lists and even videos as feedback for candidates.

#### Mark schemes / Rubrics

Using a mark scheme splits out specific areas where credits are awarded, create different areas where credits are awarded. Markers cannot input higher values than the maximum credit allocation. See our mark scheme docs for more on creation.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F0Oc95eI3pH0IhE2taHJj%2FScreenshot%202023-06-28%20at%2013.52.09.png?alt=media&amp;token=8b267fb0-9a56-4fec-bc00-f6e2b79deb9c" alt=""><figcaption><p>Mark scheme areas</p></figcaption></figure>

{% content-ref url="/pages/uweQ9G8PGBl5gp7XA77k" %}
[Adding custom marks and a rubric to questions](/docs/exams/create-and-manage-exams/marking/adding-custom-marks-and-a-rubric-to-questions.md)
{% endcontent-ref %}

#### Information for marking

Configure questions to have a box for information for markers, which supports rich text formatting if you want to link out to an external mark scheme or modal answer&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fu1YKqtS12vQLT1vkz0U2%2FScreenshot%202023-06-28%20at%2014.10.12.png?alt=media&amp;token=aa47c3a9-e425-4630-8b8f-fb3ba423341a" alt=""><figcaption><p>Information for marking box</p></figcaption></figure>

#### Feedback to candidate

Feedback to candidate will be shown to the candidate when the results are released if the questions breakdown page is enabled.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FT6gpj1JMcU0yAhngN5M8%2FScreenshot%202023-06-28%20at%2014.13.12.png?alt=media&amp;token=cf8f4ea3-ccb1-4fc3-a0f2-5646aa6c072b" alt=""><figcaption><p>Leaving feedback in the marking modal</p></figcaption></figure>

candidates will be able to see comments left about their answers, it will show under 'Markers comments'

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FRf6q9u1N2BlikOyW8Dv0%2FScreenshot%202023-06-28%20at%2014.14.47.png?alt=media&amp;token=b9ac1d24-7e7b-4be0-aba4-c7b85f5f3d11" alt=""><figcaption><p>Answer feedback appearing to a candidate </p></figcaption></figure>

#### Internal notes

Leave notes / comments for fellow markers, Student users won't be able to see these, they are available in the marking modal only&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FqCtztnuiYOIfDXiRl8qw%2FScreenshot%202024-07-25%20at%2012.28.35.png?alt=media&amp;token=69c9f094-c88c-40e0-b66d-6c49387b15b5" alt=""><figcaption><p>Internal comments left by provisional markers in a double marking exam</p></figcaption></figure>

## Releasing results

Any attempts with marks completed can be set to finalised and then released with the action buttons above the table. To release one or more results select all the attempts with a where the marks are **finalised**. Once selected use the exam controls and Release results button. This can be done individually or in bulk

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F5OVA8iM8JeKkaulEQQan%2FScreenshot%202026-09-15%20at%2014.58.04.png?alt=media&amp;token=bbca089a-467e-4879-807c-6af834b6f1de" alt=""><figcaption></figcaption></figure>

#### Result page visibility&#x20;

There are addition result page visibility options, to support releasing results for a ceratin amount of time for users. Select the individual or bulk attempts with released results and use the action button to edit the result visibility.&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FU87xqvYNGyCtY0VW5tFL%2FScreenshot%202026-09-15%20at%2014.59.41.png?alt=media&amp;token=ab5fa2e6-b164-43ab-a35f-0210354e34dc" alt=""><figcaption></figcaption></figure>

A modal will display to select the visibility settings for the selected attempt, these settings can be changed afterwards to support temporary results release.&#x20;

* **Result pages visible to candidates:** Users will be able to view the results pages that have been configured for their exam attempt.
* **Score visible to candidates**: Users will be able to see their score for the exam across tables on their insights and other areas score is displayed. Note this does not apply to the score metric box on the results page.&#x20;

{% hint style="info" %}
For results emails to send: Both Results page visible to candidates and Score visible to candidates need to be selected on the **first** result release update (from finalised to result released) to trigger the automated results email. This email will only be sent once when those conditions are met. It will not be sent following further updates to result visibility
{% endhint %}

{% content-ref url="/pages/zmNRQDlLaJOygUdF3gKz" %}
[Results](/docs/exams/create-and-manage-exams/3.-configure/results.md)
{% endcontent-ref %}

## What students see&#x20;

Students get a detailed view of each question from their exam attempts question page. Where a mark scheme has been used or comments left, they can see exactly what marks (points) they achieved. Students will not see inputs left by provisional markers they'll only see what the moderating marker has left.

![Student feedback modal with marks and comments](https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FHufNcvC3bizNjXcn2GWn%2FScreenshot%202022-05-26%20at%2014.52.20.png?alt=media\&token=7a48ab3c-07da-4ccf-a604-48045071c5a2)

![student viewing questions with marks and feedback](https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fkld8yi81Td5nutYkvtcH%2FMark%20Scheme%20Exam%20_%20Synap%20Portal.gif?alt=media\&token=4da9bcb3-d73e-4184-8fc1-a78c37042e90)


---

# 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/exams/mark-score-attempts.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.
