Preparing a rubric
A rubric tells grAider what to look for and how to award points. Prepare it before uploading student work. You can have grAider draft criteria from your teaching materials, write them yourself, or combine both approaches. Always review the finished rubric: grAider drafts it, and you decide whether it reflects your marking.
Select your assessment and choose Manage rubric to reach Edit rubric. The page follows three steps: Upload context documents, Extract rubric criteria, and Review rubric items. The help icon beside the heading opens a short introduction.
Dismiss the introduction with Ok or Escape to keep it closed for this assessment in the current browser tab, including after automatic page reloads. Never show this again disables automatic introductions across assessments in this browser. You can always reopen the introduction using the help icon.
Gather useful grading guidance
Good starting materials include the task sheet, an answer key, model answers, solution notes, and your point or deduction rules. Include acceptable alternative answers and any constraints students were expected to follow.
Make expectations concrete. For example, “Award 2 points for the correct formula and 1 point for the substitution; deduct 1 point if the final answer has no unit” is more useful than “Check the calculation.” Smaller, focused criteria are easier to review than one broad criterion covering an entire exam.
Add documents or paste text
To upload files from your computer:
- Select Upload files.
- Select Upload from this device.
- Choose one or more files. Supported formats are PDF, DOCX, PNG, JPG/JPEG, and WebP. Each file can be up to 25 MB.
- Watch the document list while grAider uploads and processes the files. Pending and Processing mean work is still in progress.
You can also select Paste text from clipboard, paste your guidance into Paste text, and choose Add document. This is useful for a short marking note or an answer key you already have as text.
For paper materials, use Take photos with a mobile device in the upload window. Scan its private QR code with your phone and upload the pages from there. Start from the rubric page so the photos become grading context for this assessment. See Uploading student work for the phone capture instructions.
If the upload window shows Service temporarily unavailable, try again after maintenance has finished.
Check the recognized text
Once a document has finished processing, use View extracted text to expand its text. Read through it and correct any mistakes, especially numbers, formulas, point values, and words that change the meaning of a marking rule. Your changes save automatically.
Where a page preview is available, View context document opens the document's pages so you can compare them with the recognized text. Close the preview when you are done. Pasted text has no page-image preview.
If something goes wrong:
- Upload failed: choose Retry upload while the document's failed-upload row is still on the page. If you have already left or refreshed the page, select the original file again through Upload files.
- Processing failed: choose Retry processing when offered. This starts another attempt to process the uploaded document.
- Wrong or unnecessary document: choose Delete file and confirm. Wait for processing to finish before deleting a document that is still being processed.
Deleting a context document does not remove criteria already extracted from it. Review those criteria separately if they are no longer appropriate.
Generate a draft rubric
- Add the documents you want to use and wait until they are ready, so the draft can include all your guidance.
- Check and correct their recognized text.
- Select Extract rubric criteria.
- If criteria already exist, read the replacement warning before continuing. Extraction replaces the existing set of criteria; it is not an “add missing criteria” action. Any manual wording or structure you want to keep should be recorded before you proceed.
- Wait while the draft is prepared. The page reloads when extraction finishes.
- Review every item under Review rubric items, including its points and grading guidance.
Adding a document alone does not update your rubric. Extract again when you want a new draft from the updated materials, or edit the existing criteria yourself. An interrupted extraction can resume automatically. While the draft is processing, wait for its status to update. If extraction fails, review the message and the available context text, then try Extract rubric criteria again.
If the tool seems to be temporarily unavailable, wait briefly before trying again.
Edit or build criteria yourself
Select a criterion's summary or its Edit criterion arrow to expand it. Use Add criterion to create a new one. You can build a rubric manually without uploading context documents.
Each criterion contains:
| Field | What to enter |
|---|---|
| Description | A clear statement of what earns credit, such as “Q1: Correct formula and substitution.” |
| Max points | The maximum available for this criterion. Use zero or a positive value; use up to two decimal places. Both 2.5 and 2,5 are accepted; values display using your selected language. Do not use thousands separators. |
| Grading context (optional) | Expected answers, acceptable alternatives, partial-credit rules, or deductions that need more explanation. |
| Point type | Choose Regular (default), Bonus, or Deduction. Bonus adds extra credit; deduction subtracts points. Neither changes the regular maximum. For deductions, enter a positive Maximum deduction. |
Check that important guidance from your uploaded materials appears in the relevant descriptions or Grading context fields. These are the instructions used to grade the work.
Break a task into subcriteria
Use Add subcriterion beneath a main criterion to split a task into smaller parts. For example, “Q2: Solve the equation” might have separate subcriteria for the method and the final answer. Fill in the main criterion first and let it save before adding its subcriteria.
Once a criterion has subcriteria, its Max points is calculated from the regular subcriteria and cannot be edited directly. The subcriteria carry the individual point limits. Parents remain regular; select bonus or deduction on individual subcriteria. Neither type increases the parent's regular maximum.
For example, regular subcriteria worth 2 and 3 points give their parent a 5-point maximum. A further 1-point bonus subcriterion remains extra credit.
Reorder or remove items
Drag a criterion by its dotted handle to change its order. You can also focus the handle and hold Alt while pressing the up or down arrow key. Reordering changes the display order and does not require existing work to be graded again.
To remove an item, open its Criterion actions menu (⋯), select Delete criterion, and confirm. Deleting a parent criterion also deletes its subcriteria.
Your changes save automatically. When you are finished, check the criteria and total points, then use Back to dashboard.
If a change cannot be saved because of an invalid value, the affected criterion opens and shows the specific error beside the field. Errors about the criterion as a whole appear inside its editor. The save status also shows the reason, including when you need to refresh an out-of-date editor. Correct the reported issue and check that saving succeeds before leaving.
Exam-wide deduction rules
Create one standalone criterion, select Deduction, and enter its positive Maximum deduction. In Grading context, state the scope and calculation, for example: “Across the entire exam, deduct 0.5 points per missing unit, at most 2 points.” grAider evaluates this rule once using all pages and explains the amount. Do not repeat the same rule under every task or also subtract it from regular scores. Check extracted deduction rules and limits before grading. Changing a type, limit, or rule requires regrading the affected criteria; unrelated teacher corrections remain.
Changing a rubric after grading
Affected submissions show Needs regrading with an amber refresh badge. The previous completed score stays visible in muted text until regrading finishes. Error is reserved for processing failures.
Previously approved individual grades keep their saved wording, scores and feedback when descriptions or grading guidance change. Once the work is open for review again, Regrade becomes available if the saved wording or guidance differs from the current rubric. Choosing it replaces scores and feedback for those criteria and drafts any missing grades. You can keep your corrections by approving the complete review as it stands. Changes to maximum points or point type require regrading the affected criteria in every submission and revoke overall approval. Added criteria need a grade; deleted criteria leave the total and also revoke approval. Unchanged grades and teacher corrections remain. No grading starts automatically. Use All (refresh icon) in the dashboard Actions header or the individual Regrade action to grade affected criteria, then check and approve the work again.
Adding or editing a context document alone does not update your rubric. Apply new guidance by editing the criteria or extracting and checking a new draft. Moving criteria into a different display order does not require another grading run.
Reference: which results are affected?
These rules apply to all submissions:
- Text changes preserve previously approved individual decisions. Unprotected grades, including manual edits not yet approved, can be removed when their criterion changes.
- Changes to a subcriterion's points do not discard unchanged sibling grades. Regrading an open review uses the current parent wording and guidance for each affected child.
- Repeated changes use the latest requirements. Changing points back does not restore a removed grade automatically.
- Extracting again reuses exactly unchanged criteria; unmatched criteria count as additions or deletions.
- If deletion leaves all remaining criteria graded, check and approve again without starting automatic grading. An empty rubric cannot be approved.
When your rubric is ready, continue with Uploading student work.
Check an exam before using it
The optional Check criteria button beside Review rubric items opens the saved review, or immediately starts the first check if rubric criteria are present. After a failed attempt, reopening shows the failure; retry explicitly with Try again. Add criteria before starting a check; uploaded documents alone are not sufficient. It uses your uploaded tasks, expected answers and saved criteria to assess clarity, fairness, available time and how well the tasks reveal different levels of understanding. For example, it may suggest asking for intermediate steps or clarifying what makes an explanation complete, so later feedback can address methods rather than repeat correct answers.
You can upload curriculum and Bildungsstandards excerpts alongside your task sheets for a source-based comparison. The review does not search the internet or open links. Existing marking guidance and the exam’s scope are taken into account. Supplied answers are treated provisionally unless the evidence contradicts them.
The editor saves pending changes before it queues the check. The check continues in the background if you leave the rubric editor. A loading panel with a spinner is shown while you wait, and the result appears automatically in the open window. If checking or loading the status fails, the panel shows a short error and Try again. Retrying checks for an ongoing or completed review first. You can close and reopen the window while it is running; this continues watching the same review. The report uses compact cards: a green check for strengths, a yellow question mark for uncertainty, and a red exclamation mark for problems with concrete improvements. Each card has a short generated heading and is collapsed by default. Select its heading to expand or collapse the feedback. The review immediately assesses competencies, difficulty, AFB balance and working time using the available materials. It uses school country, school type and class information to infer likely level, briefly stating material assumptions.
Every new report addresses four topics, with explicit limits where information is missing:
- Competencies: maps tasks to assessed competencies and, when supplied, named competencies in the standards excerpts. Without those sources, the mapping is provisional.
- AFB I–III: gives advisory task classifications and points/percentages when the marking scheme supports them. Parent totals are not added to subcriteria; bonus and deductions are separate. Ambiguous points remain unclassified and count in the total. Missing or contradictory points are flagged; percentages are not invented.
- Curriculum alignment: gives a provisional assessment of subject coverage and difficulty for the likely educational context. It briefly notes when the specific curriculum has not been checked, without routinely requesting sources. If excerpts are supplied, it compares against them; partial sources cannot establish full compliance.
- Working time: estimates a range in minutes including reading/checking time and material assumptions about level and aids. Task/group times are added when they explain a bottleneck or proposed change. It compares this with the available duration when known. Insufficient evidence is made explicit.
Reports contain four to six short cards, prioritizing the most useful findings and concrete improvements. AFB categories with zero points remain visible; an unclassified line appears only when needed. The latest report is saved with the assessment. Reopening the window does not start another review. If the materials have changed, a Materials changed — not yet checked notice replaces the old cards. Choose Check updated materials to review the current version. A successful review replaces the saved report. A failed attempt keeps the previous report saved, but outdated cards remain hidden. A technical failure is not a finding about your exam. Timeout and failure messages remain available when you reopen the window; your saved edits are preserved. Wait for uploaded documents to finish processing, and retry or remove failed documents before checking.
Cards labeled Suggested rubric change include a separate Proposed change panel. Read the proposal and choose ✓ Apply change to have grAider revise the complete rubric, or Keep current criteria to decline it. A proposal can change wording, guidance, points and point types, or add, remove, split, merge and reorder criteria. Related changes are grouped into one proposal. Other feedback remains advisory.
Applying a change saves the revised rubric, refreshes the editor and reopens the review. The change runs in the background. The selected proposal’s Apply button shows a spinner until the editor reloads the saved criteria. Check the resulting criteria. Applied and dismissed decisions remain visible when you reopen the review; there is no Undo action. If applying fails, the suggested change is not applied. You can retry or edit the criteria manually. You can apply other independent proposals to the updated rubric, then choose Check again for an updated assessment. A new review replaces the previous proposals and decisions.
You can apply proposals before, during or after grading. The same protection rules above apply: text edits preserve previously approved individual decisions, while point changes require regrading affected criteria in all submissions. Unchanged decisions remain. Start regrading from the dashboard and check the new drafts. If you edit materials yourself, use Check updated materials before applying remaining proposals. The review never edits the uploaded task sheet; reviewing alone does not change grades.