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

# Grade a quiz, exam, worksheet or problem set

> Grade per question against your answer key, on a screen that looks nothing like the writing one.

export const updated_0 = "19 September 2026"

export const page_0 = "/teachers/review/question-based"

export const label_0 = "Open your dashboard in GradingPal, then pick a submission"

export const href_0 = "https://app.gradingpal.ai/teacher"

export const who_0 = "Teachers and co-teachers"

export const plans_0 = "All plans, with the All Assignment Types add-on on Lite"

export const where_0 = "The grading screen for a question-based assignment"

<Card title="Who can use this?" icon="user-check">
  * **Who:** {who_0}
  * **Plans:** {plans_0}
  * **Where:** {where_0}
</Card>

### Limits and notes

* Objective questions, such as multiple choice, matching and ordering, are scored from the recorded answer against your answer key. To fix a wrong score, correct the recorded answer; the score follows.
* The AI matches each question to the pages it's answered on. When it picks the wrong page, the score and feedback come from the wrong page too. **Assign pages** fixes it.
* Approving and sharing work the same as on any grading screen: **Approve & next** at the top, and nothing reaches students until you share.

## The three panes

| Pane                          | What it holds                                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Questions** rail, left \[1] | One row per question with a status dot and its score, or **Blank**. Click a row and the other two panes jump to it          |
| **Submission**, centre        | The student's scanned pages, opened to the page the selected question is answered on. Its toolbar has **Adjust pages** \[2] |
| Grading column, right         | **Total score** at the top, **Overall feedback**, then one card per question                                                |

## Read a question card

Each card shows **Question N**, its kind (**Multiple choice**, **Short answer**, **Essay**, **Diagram**, **Problem**), the prompt, the score, a pages chip such as **p.3–4**, and the student's answer as recorded: **Student's response** for multiple choice, **Student's selections**, **Student's matches**, **Student's order**, or **Student answer** for typed work. A verdict chip reads **Correct**, **Partially correct · 3 of 5**, **Incorrect** or **Missing**. Below sit the feedback tabs **Feedback**, **Strengths** and **Improvements**, plus **Grammar** when the check is on.

Three states need a second look:

* **Not answered**: the student left it blank, or the AI thought so. Select **Mark answered** if the work is there.
* **No response provided.** The card's answer area for a question marked not answered.
* **Visual question**: "Accuracy may be lower for diagrams & images. Please double-check the AI grading."

## Fix a score

<Steps>
  <Step title="On an objective question, correct the recorded answer">
    Select the pencil beside the answer, **Edit student's response**, and set what the student actually chose. Choose a reason: **AI misread the student's answer**, **Answer key is wrong**, **Accepting an equivalent answer** or **Illegible or ambiguous response**. Select **Confirm change**. The score recomputes.
  </Step>

  <Step title="On a rubric-graded question, change the level or points">
    Click a level or the points on the criterion card, choose **Too harsh**, **Too generous**, **Missed evidence**, **Misread the work** or **Rubric judgment**, and **Confirm change**. [Change a score](/teachers/review/change-a-score) has the detail.
  </Step>
</Steps>

## Fix the pages

<Steps>
  <Step title="Open Assign pages">
    Select **Adjust pages** in the scan toolbar, or the pages chip on a card. The **Assign pages** editor lists the questions on the left and the pages on the right.
  </Step>

  <Step title="Pick the right pages">
    Select a question, then click its pages; shift-click for a range. A question with no pages shows **no pages** in amber.
  </Step>

  <Step title="Done, then regrade">
    Select **Done**. If a mapping changed, GradingPal asks **Re-grade this question?** and explains the score still comes from the wrong page. Select **Re-grade it**. Only that question is regraded; your other edits stay.
  </Step>
</Steps>

## How to tell it worked

Every rail row has a score, the **Total score** card counts "N of N answered", and no card carries the **Not answered** badge unless it should.

## If something goes wrong

<AccordionGroup>
  <Accordion title="No grades available">
    "No answers could be matched to the rubric questions." The wrong file was uploaded, or the scan is unreadable. Check the pages, replace the file if needed, then select **Regrade**.
  </Accordion>

  <Accordion title="A score is wrong and the answer is recorded correctly">
    Check the answer key on the assignment's **Assignment** tab. If the key is wrong, fix it there and choose **Save & re-grade**.
  </Accordion>

  <Accordion title="The feedback is about the wrong question">
    The AI read the wrong page. Fix it with **Assign pages** and regrade that question.
  </Accordion>
</AccordionGroup>

## Related tasks

* [Review questions and answer keys](/teachers/create/questions-and-answer-keys)
* [Change a score](/teachers/review/change-a-score)
* [Review and approve grades](/teachers/review/review-grades)
* The screen has a guided tour. Open the menu at the top right and select **Take a tour**.

<Card title={label_0} icon="arrow-up-right-from-square" href={href_0} horizontal>
  Opens GradingPal on the screen this page describes.
</Card>

<hr />

<p style={{ fontSize: "0.875rem", opacity: 0.75 }}>Last updated {updated_0}</p>

<p>
  <strong>Was this page helpful?</strong>{" "}
  <a href={"mailto:support@gradingpal.com?subject=" + encodeURIComponent("Help page feedback (helped): " + page_0)}>Yes, this helped</a>

  {" · "}

  <a href={"mailto:support@gradingpal.com?subject=" + encodeURIComponent("Help page feedback (problem): " + page_0) + "&body=" + encodeURIComponent("Which of these fits? Couldn't find the step / Didn't match what I see / Missing information / Out of date / Other\n\nTell us more:\n")}>No, something's wrong</a>
</p>

<p style={{ fontSize: "0.875rem" }}>
  <a href={"mailto:support@gradingpal.com?subject=" + encodeURIComponent("Problem with help page: " + page_0)}>Report a problem with this page</a>
</p>