Grade Tracking

PlanStudyBoost lets you keep all your assessment results in one place — tests, quizzes, assignments, practicals — linked to the subject they belong to. Navigate to Grades in the sidebar to open the dedicated grades page (/grades).

What is a grade?

A grade records the result of one assessment:

Subject — which subject the assessment belongs to
Assessment name — e.g., "Chapter 5 Quiz" or "Term 2 Exam"
Score — points you received and the maximum possible (e.g., 17 out of 20)
Date — when you received the grade
Term — optional label to group grades by term or semester (e.g., "Term 1", "Semester 2")

PlanStudyBoost automatically calculates your percentage and assigns a colour-coded label.

The Grades page

The Grades page lists all your assessment results grouped by subject, with the most recent grade for each subject shown first.

Subject filter chips

A row of chips at the top of the page lets you narrow the view to a single subject:

Select any subject chip to show only that subject's grades
Select All to return to the full grouped view

Grade cards

Each grade appears as a card showing:

Assessment name
Raw score (e.g., 85 / 100)
Term label, if one was entered
Date received
A colour-coded badge with the percentage and label

A delete icon (🗑) is shown on cards for grades you entered yourself. Grades entered by a parent or supervisor show no delete icon — only the person who entered a grade can remove it.

Grade labels

Each grade is automatically categorised and colour-coded:

Percentage	Label	Badge colour
90% and above	Excellent	Green
75%–89%	Good	Emerald
60%–74%	Satisfactory	Yellow
50%–59%	Needs Improvement	Orange
Below 50%	Failing	Red

Entering a grade (students)

You can enter your own grades when self-grading is enabled on your account. Self-grading is on by default — it is only turned off if a parent with grade-entry permission has linked to your account.

To add a grade:

Go to Grades in the main navigation
Select + Add Grade (if this button is not visible, self-grading is disabled — see below)
Fill in:
- Subject — choose from your active subjects
- Assessment name — describe the test or assignment (max 80 characters)
- Score — points you received
- Out of — the maximum possible score (must be greater than 0)
- Date — when you received the grade (today or in the past)
- Term — optional; e.g., "Term 1" or "Semester 2"
Select Save Grade

The new grade appears immediately in the correct subject group without reloading the page.

If the + Add Grade button is not shown, your self-grading is disabled because a parent with grade-entry permission is linked to your account. Ask your parent to enter the grade, or ask them to update their permissions. See Self-Grading for details.

Entering a grade (parents)

If you are a parent linked to your child's account with Enter Grades permission, you enter grades from the same Grades page — your view adapts automatically.

Getting to your child's Grades page

Select Grades in the sidebar. The page opens for the child currently in context on your dashboard. If you have more than one linked child, a student switcher bar appears at the top of the page — select a chip to switch to a different child.

Visiting /grades without a student context redirects you to your dashboard to choose a child first.

Adding a grade as a parent

On your child's Grades page, select + Add Grade (this button is only visible when your link has Enter Grades permission)
Fill in:
- Student's subject — chosen from your child's active subjects
- Assessment name — describes the test or assignment (max 80 characters)
- Score — points your child received
- Out of — the maximum possible score (must be greater than 0)
- Date — when the grade was received (today or in the past)
- Term — optional label, e.g., "Term 1"
Select Save Grade

The grade appears immediately in the list.

The grade is recorded as entered by you. Your child can see it but cannot delete it — only you (or an administrator) can remove a grade you entered. For details on the parent-student link and permissions, see the Parent Guide.

Deleting a grade

Grades cannot be edited. If you need to correct a mistake, delete the grade and re-enter it.

To delete a grade:

Find the grade card in the list
Select the 🗑 delete icon on the right side of the card

The delete icon only appears for grades you entered yourself.
A confirmation message appears inline: "Delete [name]? This cannot be undone."
Select Yes, delete to confirm, or No, keep it to cancel

The grade is removed from the page immediately.

Empty states

Student view

Situation	What you see
No subjects created	A prompt to go to Subjects first
Subjects exist but no grades entered (self-grading enabled)	"No grades yet" with an + Add Grade link
Subjects exist, self-grading disabled	"No grades yet — your parent or guardian will enter your grades when assessments are completed"
Filtered to a subject with no grades	"No grades for this subject"

Parent view

Situation	What you see
Child has no subjects	"No subjects set up yet — grades will appear here once subjects exist"
Child has subjects but no grades (Enter Grades permission)	"No grades recorded yet — add [child's name]'s first grade when an assessment is completed" with an + Add Grade link
Child has subjects but no grades (view-only permission)	"No grades recorded yet — grades will appear here when [child's name]'s assessments are recorded"
Filtered to a subject with no grades	"No grades for this subject"

Frequently asked questions

Can I enter a grade for a future date?

No. The assessment date must be today or in the past.

What if the maximum score is not 100?

That's fine — enter the actual score and maximum. For example, 17 out of 20 is stored as 17 / 20, and the percentage (85%) and label (Good) are calculated automatically.

Can I track grades across multiple terms?

Yes. When adding a grade you can optionally enter a term label (e.g., "Term 1", "Semester 2"). Full term management is coming in a future update.

What happens to my grades if a parent links to my account?

Existing grades are preserved. Only the ability to enter new grades changes — if your parent has grade-entry permission, they take over grade entry going forward.

Can I edit a grade I've entered?

No. Grades are locked after saving to preserve an accurate record. To correct a mistake, delete the grade and re-enter it with the correct values.

Self-Grading — How the student / parent permission model works
Subjects — Grades are linked to subjects
Analytics — Track your progress over time
Parent Guide — Grade entry from a parent's perspective