Skip to main content
Schoolyi
School librarian arranging books and planning cards in a bright library

Browse docs

Grades & homework

Report cards and remarks

How a term report card is assembled from published assessments, who may add remarks, who may publish to families, and what the published snapshot freezes.

Grades & homework guide for day and boarding schools.

Last updated August 29, 2026

A term report card is assembled, not authored. For each student the system reads every PUBLISHED assessment for their active class whose assessment date falls between the term start and end dates, groups them by subject, sums obtained and maximum marks, and converts the percentage to a letter using the school grading scale. Term boundaries come from the academic calendar, so a card is only as correct as the term dates configured there.

Mark status changes the arithmetic. An EXEMPT mark is excluded from both the obtained and maximum totals, so a student who genuinely sat a paper out is not penalised; a subject where every assessment is exempt is shown as exempt rather than scored. An ABSENT mark fails the subject. The overall result is a pass only when no subject fails and the total percentage clears the pass threshold derived from the grading scale. Attendance printed on the card is counted from full-day register marks inside the term, not from leave records.

Prerequisites

  • Terms defined for the academic year on the Terms tab at /academic-calendar - the card window is the term start and end date.
  • A grading scale at /settings/grading-scale; without one the default CBSE bands apply, and the pass threshold is taken from the lowest band that still scores points.
  • Assessments published for every subject the class studies, or publish will be blocked.
  • Class and co-class teachers assigned, since remarks are written by homeroom staff.

Screens and permissions

ScreenPathWho and what
Grades hub/gradesTeachers - assessments, marks, and a Report cards tab
Report cards/grades/report-cardsClass teachers write remarks and read publish readiness; only leadership sees the publish action
PDF preview/grades/report-cards/preview/[studentId]/[termId]Print-ready layout; before publish it renders live data, after publish the frozen snapshot
My grades/my-gradesStudent - published cards for the current year
Parent grades/parent-dashboard/gradesParent - per child, published cards only
Grading scale/settings/grading-scaleAdmin - band to letter mapping and pass threshold

The publish snapshot

  • Publish runs for a whole class and term at once and refuses if any active student is missing marks in any subject, naming the students and subjects.
  • For each student it writes a per-subject snapshot row plus the totals, percentage, letter grade and remark, then marks the card published.
  • Downloads after publish read the snapshot, so a later mark correction does not silently reissue a different PDF.
  • Students and linked parents are notified in-app, and by email when the channel is enabled.
  • Amending re-assembles from current marks, writes a fresh snapshot, increments the revision, and notifies families that the card was updated.
  • Unpublishing hides the card from families but keeps the snapshot and writes an audit entry; both amend and unpublish require a written note.

What breaks if you skip or reorder

  • Term dates wrong: assessments dated outside the window are simply not seen, and the card reports subjects as having no data.
  • Grading scale changed after publish: published cards keep the letters frozen at publish time, but drafts, previews and live views immediately recompute against the new bands - so a class published before the change and one published after will not agree.
  • An assessment published late: it is not added to an already-published card until someone amends that card.
  • A student enrolled after publish: they have no card for that term until publish is run again for the class.

Handoff and limits

Report cards read from the gradebook and hand off to the student and parent portals and to notifications. Formal exam results reach a card only because publishing an exam paper creates a published assessment in the gradebook; the exam session’s own grade cards are a separate publication with a separate audience gate.

  • Bulk PDF generation is capped at 80 students per request - split a large class by section.
  • The stored snapshot does not include attendance, so a PDF regenerated from a published card shows zero attendance days.
  • There is no per-subject teacher remark on a term card; remarks are one free-text note per student, up to 500 characters.

Common questions

Quick answers in plain language.

Why is publish blocked with a missing-marks error?+

Publish checks every active student in the class and lists anyone whose assembled card has a subject with no data or no obtained mark. Usually the cause is an assessment still in draft, or an exam-linked assessment whose mark rows were seeded but never filled in. Publish the outstanding assessments or enter the marks, then reload publish readiness.

What happens to published report cards if we change the grading scale mid-year?+

Already-published cards are unaffected because publish freezes the letter grades into a snapshot that downloads read from. Drafts, the preview screen and publish readiness recompute against the new bands straight away. If you want published cards to reflect the new scale you must amend them, which re-assembles, bumps the revision and notifies families.

Can a class teacher publish report cards for their own class?+

No. Class teachers write the remarks and can see who is ready, but publish, unpublish and amend are limited to Platform Admin, Admin, Principal and Vice Principal. This is the boundary that controls what reaches families, so it is deliberately narrower than mark entry.

How is the attendance figure on the card calculated?+

It counts full-day attendance records for that student inside the term dates and divides present days by total marked days. Days nobody marked are not counted at all, and approved student leave does not change it - leave and the register are separate records.

Related searches

School leaders and IT teams often search for: bulk report card PDF, and publish grades parents.