> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillfactory.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Grading Questions

> How to evaluate open-ended responses, assign grades, and provide student feedback

## Grading questions

Evaluate student essay responses and provide constructive feedback. Multiple choice questions are graded automatically, but open-ended questions require manual evaluation by the teacher.

## Accessing pending grading

<Steps>
  <Step title="Access the quiz metrics page">
    In **Quizzes**, locate the desired quiz and click **Metrics**. You will see the list of all students who have made attempts.
  </Step>

  <Step title="Select a student">
    Click on the student to see their attempts. Each attempt shows status, score, total correct answers, and elapsed time.
  </Step>

  <Step title="Access grading">
    Click **Grade** on the desired attempt to see all of the student's responses, question by question.
  </Step>
</Steps>

## Grading page

The grading page displays, for each question in the attempt:

| Information            | Description                                              |
| ---------------------- | -------------------------------------------------------- |
| **Prompt**             | Full text of the question                                |
| **Student's response** | What the student answered                                |
| **Question score**     | Maximum possible value                                   |
| **Score field**        | For you to assign the points (0 up to the maximum value) |
| **Feedback field**     | Comment for the student about the response               |

For **multiple choice** questions, the grading already appears filled in automatically (correct or incorrect). For **open-ended** questions, you need to:

1. Read the prompt to recall what was asked
2. Analyze the student's response
3. Assign a score from 0 up to the maximum value of the question
4. Write feedback explaining the evaluation
5. Save the grading

<Info>
  The feedback is visible to the student on the quiz results page. Use it to guide learning.
</Info>

## Final score

The quiz final score is calculated automatically as the sum of each question's score. However, the teacher can **override the final score** when necessary.

### Manual score override

| Field                     | Description                                            |
| ------------------------- | ------------------------------------------------------ |
| **nota\_final\_manual**   | Numeric value that replaces the calculated score       |
| **nota\_final\_override** | Flag indicating that the score was manually overridden |

When you set a manual final score:

* The calculated score (sum of questions) is preserved in the history
* The score displayed to the student becomes the manual score
* A visual indicator shows that the score was overridden by the teacher

<Warning>
  Overriding the final score affects the student's pass/fail status. If the quiz has `minimo_acertos` configured, the manual score is used to determine whether the student passed.
</Warning>

### When to use override

* The student experienced technical issues during the attempt
* You want to consider extra factors not captured in the questions
* The automatic grading for multiple choice needs adjustment (ambiguous question)
* The student deserves extra credit for participation or effort

## Grading flow for mixed quizzes

For quizzes of type `diversos` (combining multiple choice and open-ended):

1. Multiple choice questions arrive already graded automatically
2. Open-ended questions remain pending grading
3. The partial score (objective only) is displayed as provisional
4. After grading all open-ended questions, the final score is recalculated
5. The student sees the updated score with all questions evaluated

## Conflict protection

The system uses a unique index to protect against race conditions during grading. If two teachers attempt to grade the same question simultaneously, only the first grading is recorded and the second receives a warning.

## Attempt data

On the quiz metrics page, you see the following data for each student:

| Data                | Description                                   |
| ------------------- | --------------------------------------------- |
| **Name and email**  | Student identification                        |
| **Attempts**        | Total number of attempts made                 |
| **Best score**      | Highest score among all attempts              |
| **Average**         | Average score among finished attempts         |
| **Status**          | `finalizado`, `em_andamento`, or `abandonado` |
| **Elapsed time**    | How long it took to complete                  |
| **Start date**      | When the attempt was started                  |
| **Completion date** | When it was finished                          |

## Overall quiz statistics

The metrics page also displays aggregated statistics:

* **Total students** who took the quiz
* **Total attempts** (including multiple per student)
* **Finished attempts** vs in progress vs abandoned
* **Overall average** scores
* **Highest and lowest score** among all students
* **Pass rate** (percentage above the minimum correct answers, when configured)

## Next steps

<CardGroup cols={2}>
  <Card title="Create quizzes" icon="file-pen" href="/en/teachers/creating-quizzes">
    Configure new quizzes and questions
  </Card>

  <Card title="Analytics" icon="chart-line" href="/en/teachers/analytics">
    Analyze overall performance of your quizzes
  </Card>
</CardGroup>