# Grades

Grades in Synap define how candidate performance is evaluated and how final outcomes are awarded for an assessment.

Each grade represents a **performance boundary**, allowing you to classify results such as Pass, Fail, Merit, or Distinction. Grades are based primarily on a candidate’s **overall score percentage**, and can optionally include additional conditions when advanced grading features are enabled.

Grades help you:

* Define pass marks and performance levels
* Control certification or progression outcomes
* Provide clear feedback to candidates
* Apply structured grading frameworks to assessments
* Award certificates
* Automate resits (resit on failing grades)&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FI2cTihRQqZm44V73NivL%2FScreenshot%202026-03-19%20at%2011.35.29.png?alt=media&#x26;token=8f41ca7b-dcbf-4e2c-a4d2-de9962de01fd" alt=""><figcaption></figcaption></figure>

### Creating grades

Grades can be configured on quizzes or exams, the steps are the same. If you're using static exams we'd recommend creating grades on source quizzes so you don't need to repeat the steps on every exam. Navigate to the grades page on exams or quizzes, and add grade

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2Fd8TPI8pSLAuaZi9k1orV%2FScreenshot%202026-03-19%20at%2011.33.40.png?alt=media&#x26;token=36fe6e9c-589c-4d32-8a8d-cddc754cbb72" alt=""><figcaption></figcaption></figure>

From the add grade modal fill in the information, using the Achievement criteria tab to input a minimum score

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FUbPY6xpD2e0JAAFUe7nq%2FScreenshot%202026-03-19%20at%2011.39.03.png?alt=media&#x26;token=195025a5-9a9c-4228-950c-5a23739ed62d" alt=""><figcaption></figcaption></figure>

* **Label**: The title of the grade that shows to the user&#x20;
* **Type**:  Pass or Fail grade (at least one of each is required)&#x20;
* **Order**: Where advanced grading criteria is being used, order lets you separate different grades that have the same minimum score set.&#x20;
* **Description (optional):** Doesn't show on platform, available in webhook and API payloads
* **Minimum score:** The lowest overall percentage a candidate must achieve in an assessment to be awarded that grade. When an attempt is marked, Synap compares the candidate’s final score against each configured grade boundary. If the score meets or exceeds the minimum score for a grade, that grade becomes eligible to be awarded.

$$
Score = 100\*\left \[  \frac{Total : achieved : credits}{Max:available: credits}\right ]
$$

On Synap, a candidate’s score percentage is calculated using the total number of **credits achieved** compared to the **maximum credits available** in the assessment.The final percentage is rounded to **two decimal places**. For assessments where each question is worth **one credit (one mark)**, this calculation is equivalent to:

$$
Score = 100\*\left \[  \frac{Total : number : correct : questions}{Toal :number: questions}\right ]
$$

Once you're grades are created apply changes and save. See below for examples of grades

<table data-header-hidden><thead><tr><th width="119.181396484375">Grade</th><th>Minimum score</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Grade</strong></td><td>Minimum score</td><td>Type</td><td>Information</td></tr><tr><td>A</td><td>80%</td><td>Pass</td><td><p>users with 80% or above will achieve the A grade, and pass</p><p></p></td></tr><tr><td>B</td><td>70%</td><td>Pass</td><td><p>users with 70% or above will achieve the B grade, and pass. </p><p></p></td></tr><tr><td>E</td><td>40%</td><td>Pass</td><td><p>40% is the lowest a user can possibly score in order to pass.</p><p></p></td></tr><tr><td>Fail</td><td>0%</td><td>Fail</td><td>users with between 0% and 39% will fail this exam.</td></tr></tbody></table>

### Grades and Section grades

Synap allows you to define **grades for the overall assessment** as well as **grades for individual sections**.

Overall grades classify a candidate’s final performance based on their total score across the exam, while section grades evaluate how well a candidate performed within specific parts of the assessment.

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2F12icslL0ajE5ETBtoybC%2FScreenshot%202026-03-19%20at%2011.36.07.png?alt=media&#x26;token=e842f1b7-f9f1-4af1-9666-b58901856c5e" alt=""><figcaption></figcaption></figure>

Using both together helps you structure assessments more clearly and provides more detailed insight into candidate performance. See our guide below on for how to create section grades

{% content-ref url="sections-1" %}
[sections-1](https://academy.synap.ac/doc/quizzes/creating-a-quiz/sections-1)
{% endcontent-ref %}

### Advanced grading criteria

Advanced grading criteria allow you to define **additional section conditions** that candidates must meet to be awarded a specific overall grade.

{% hint style="info" %}
Advanced grading criteria available on Pro, Business and Enterprise plans
{% endhint %}

By default, grades in Synap are awarded based only on a candidate’s **overall score percentage**. Advanced grading criteria make it possible to include **section-level performance requirements** as part of the grading decision

This enables more flexible and realistic assessment models, particularly where competency must be demonstrated across specific areas of an exam.

Examples include:

* Passing all sections
* Passing specific sections
* Passing a minimum number of sections
* Excluding a grade from resits (ie capped resit grades)&#x20;

This is particularly useful in assessments where strong performance in one topic should not compensate for weak performance in another.

To be awarded a grade, a candidate must:

* Achieve the **minimum overall score** for that grade
* AND meet any **configured section requirements**

If multiple grades meet all required conditions, Synap awards the **highest priority grade** based on the configured grade order.

From the grades page on exams or quizzes, enable advanced grading criteria (must have section grades enabled and set up in order to use)&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FMGd2N2neGMM7huubTxB3%2FScreenshot%202026-03-19%20at%2012.05.52.png?alt=media&#x26;token=6be01ff9-0ee0-4276-ba22-5731e7153502" alt=""><figcaption></figcaption></figure>

When creating or editing existing grades go to the Achievement criteria tab to configure the additional section requirements as well as minimum score&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FeR2K2epP0WQ3grXefjlE%2FScreenshot%202026-03-19%20at%2012.42.25.png?alt=media&#x26;token=55bd9b9e-b453-48d6-89ab-c38e931932ec" alt=""><figcaption></figcaption></figure>

* **None** =  There are no additional section requriements needed in order to achieve this grade
* **Must pass all sections** = All sections much have a passing section grade in order to achieve this grade
* **Must pass any specific number of sections** = Input a count of the total number of sections that a section pass grade must be achieved in order to achieve this grade
* **Required sections must be passed** = State one or more specific sections that must be passed in order to achieve this grade
* **Exclude all resit attempts from this grade (exam only)** = Grade will be excluded from attempt resits when resits are enabled on exams&#x20;

{% content-ref url="../../exams/create-and-manage-exams/3.-configure/resits" %}
[resits](https://academy.synap.ac/doc/exams/create-and-manage-exams/3.-configure/resits)
{% endcontent-ref %}

Synap will allow you to have multiple overall grades with the same minimum score requirements. In this scenario the system will award the highest grade by the given order, drag and drop to rearrange the order&#x20;

<figure><img src="https://3316915154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkgvUeCmTPeNouRxGPC%2Fuploads%2FY3ILydWqJbYehqNWU4lG%2FScreenshot%202026-03-19%20at%2012.46.05.png?alt=media&#x26;token=c0c883c1-cc1a-43e1-955f-e499752e3414" alt=""><figcaption><p>Same minimum score different order grades</p></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://academy.synap.ac/doc/quizzes/creating-a-quiz/grades.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
