The Assessment gradebook is a powerful tool that helps you track student performance in your class. It offers real-time insights into MYP criteria-based results and overall growth patterns.
In this article, you will learn how to:
Navigate and understand the Gradebook layout
To open the gradebook:
Go to your Class from the homepage
In the left menu, click Gradebook → Assessment gradebook.
Once inside, you will see a table bringing together all your assessment data. Here is what you will see:
1. Student roster
List of all active students (with option to include archived students).
2. Assignment columns
Each assignment column contains:
Assignment details: Task name, creation date, and due date.
Assessment tools: How the task was evaluated (scores, rubrics, checklists, MYP criteria).
Evaluation status: Pending, completed, or shared with the student.
Grading category: Homework, projects, tests, etc.
Task type: Formative (FA), Summative (SA), or other.
Student performance: The actual evaluation (score, rubric level, checklist status, etc.) for each student.
3. Calculated grades
Category scores (e.g., average of homework, tests, projects).
Overall grade for the grading period.
Note: Visibility of the grades depends on the admin grading setup and the teacher display choices.
Customize your gradebook view
The gradebook is designed to be flexible and responsive. Use the toolbar at the top of the screen to filter your view and focus on the data that matters most.
Grading period selector
Switch between different grading periods of the current academic year to view relevant assessments. By default, it will open to the ongoing period.
Note: This is the most important filter, as your selection determines which tasks and calculated grade columns are visible. However, the grading period you select is not retained — when you navigate away and return to the Gradebook, it will always open to the ongoing grading period.
Filters menu
For more specific control over your view, click the ‘funnel icon’ to open the following filter options:
1. Assignment types: Focus on specific kinds of tasks, such as 'Formative assessment,' 'Summative assessment,' or 'Worksheet' assignments.
2. Assessment tools: See only assignments that use a specific evaluation method, like an 'MYP criteria rubric,' a 'Checklist,' or 'Score'.
3. Grading categories: Filter tasks based on the assessment categories they are tagged to. These help you analyze student performance by task type (e.g., comparing exam performance vs. classwork).
Note: The availability of this filter depends on your other selections. It will only appear if the selected grading period has categories defined by your administrator, and it is not available if you have selected a cumulative grading period.
4. Students: Isolate data for one or more students. This helps prepare for parent-teacher conferences or focused conversations with a student about their progress. The archived students, if any, are unselected in this list by default.
Note: When a Cumulative grading period is selected, Students is the only option available in the Filters menu.
5. Assessment criteria: Narrow your view to assignments tagged to specific MYP year objectives, such as ‘Year 1 Objectives’. This is useful for analyzing student performance against specific learning targets.
Display options
In addition to filters, you can tailor your gradebook layout using display options. Click the three-dot menu → Configure gradebook views to open a settings panel with two tabs: Configure columns and Display settings.
Configure columns
On this tab, you control which data columns are visible and their order.
Show or hide columns: Use the checkboxes to toggle visibility of individual data columns
Reorder columns: Use the six-dot icon next to a column name to drag and drop it into your preferred position.
Display settings
This tab allows you to customize how individual assignment columns are presented.
Assessments details: Choose to show or hide 'Assignment type,' 'Grading category,' and 'Due date.'
Highlight cells – Enable color highlights to visually track submission and evaluation progress across the Gradebook. You can choose to highlight late submissions, tasks not submitted, overdue submissions, or open submissions.
Sort assessments by: Arrange assignments chronologically by 'Due date' or 'Creation date,' or alphabetically by student name.
Category view: Group tasks by category or show the category name alongside the assignment.
Others: Show tasks that are excluded from the final calculation or include tasks that have been carried over from a student’s other classes.
Tip: Filters and display settings are retained when you navigate away and return to the gradebook. They also carry over across all your classes.
View and interpret grades
The Assessment gradebook gives you real-time insights into how students are progressing individually and as a class. Here's how to make sense of what you see:
Understand the grading setup
To understand how scores are being calculated, open the three-dot menu → Grading setup.
This panel gives you a read-only view of how grading has been configured for your class by your admin (unless you have edit permissions). Each grading period has its own setup, so make sure to switch to the relevant grading period tab to see the correct configurations.
To learn in detail about how the Grading setup is configured in the MYP, check out our articles.
Configure MYP grading criteria
To configure MYP criteria for students, head to the three-dot menu → MYP criteria configuration.
Use this tool to assign different MYP objectives/phases to individual students within the same class. This is essential for managing phase-based subjects (like Language acquisition), mixed-grade level classes, or accommodating individual student needs.
Click the ‘Edit’ button to configure year objectives/phases for individual students.
Interpret grades for a reporting period
Use the gradebook to analyze student performance across individual assessments, MYP criteria, and overall grading periods. You can access detailed score breakdowns, grade boundaries, and historical insights - all within a few clicks.
1. View evaluations for a specific assessment
Click on any cell in the gradebook corresponding to an individual assessment to open a panel on the right. Here, you can view:
Evaluations for all assessment tools attached to that task - such as rubrics, checklists, scores, comments, and learning goals.
The best-fit rating for each criterion, if the assessment uses an MYP rubric.
Any comments or scores entered for that student.
This panel allows you to easily confirm how the student was evaluated for a particular task, across all assessment tools.
2. View breakdown for category or term-level scores
When you click on any aggregated score, such as a category total or overall term score, you’ll see:
A complete list of the assessments that contributed to that score.
The score achieved in each contributing assessment.
Depending on the grading setup, the overall score for the grading period may be calculated either directly from individual assignments or from category-level scores.
Accordingly, the breakdown you see in this panel will vary to reflect the chosen calculation method.
This gives you visibility into exactly how each overall score was calculated.
3. Analyze MYP criterion-based scores
If you click on any criterion score (e.g., Criterion A, B, C, or D), the right panel displays:
A graph showing the student’s scoring trend across assessments for that criterion.
A detailed list of all assessments that were evaluated on that criterion.
The evaluation history across different grading periods or academic years (accessible via tabs at the top of the panel and via the academic year filter respectively).
This helps you track a student’s growth across specific strands of the MYP objectives.
4. Analyze the overall MYP grade
Clicking on the ‘Overall grade’ column gives you a comprehensive view that includes:
The final IB grade (1–7) based on total MYP criteria performance.
A bar graph showing the student’s rating across Criteria A–D.
A breakdown of the specific assessments that contributed to each criterion score.
A full record of evaluation history with year and term filters.
Unlike individual task scores, the MYP criterion ratings (A–D) for the overall term are not auto-populated. Teachers can use the evaluation history to apply a “best fit” judgment, ensuring that the awarded grade reflects a student’s overall growth and performance.
This view is particularly useful for summarizing student achievement in preparation for reporting or parent-teacher discussions.
Note: This view is available only if the overall grade is configured to be calculated based on MYP criteria in the grading setup.
5. Understand how grade conversions are applied
Clicking on any grade column, such as the Local Grade, opens a panel that displays:
The grade conversion scale used to arrive at the final grade (e.g., how 84% maps to a 6 on the IB scale, or to an A− in your school’s local system).
This ensures transparency in how student achievement is interpreted and reported.
Interpret grades for a cumulative grading period
Alongside individual reporting periods, you can select a cumulative period (such as ‘Semester 1’ or the full academic year) to see how scores from multiple terms combine into a final result.
Final scores for cumulative periods are automatically calculated based on the weightage defined by your school administrator. For example, a cumulative score like 'Semester 2' might be calculated by weighting 'Term 3' at 40% and the 'Exam' at 60%.
In this view, the gradebook displays:
Summary columns for contributing periods: You will see the overall score and grade for each reporting period, which are included in the cumulative calculation. This helps you understand how each term contributed to the outcome.
Overall score: The final score for the cumulative period, based on the defined weightages.
Grading categories: Scores for each assessment category (e.g., 'Participation', 'Speaking') across the cumulative period, if enabled.
Overall grade: The IB grade (1–7) based on the cumulative score or category totals.
Local grade: Your school’s local grade (e.g., A+, B) derived from the cumulative score.
Note: The grading method (score-based or category-based) is defined in the grading setup by your school.
Evaluate and share assignments in the gradebook
The Gradebook allows you to evaluate student work and manage how grades are shared with students and families.
There are two ways to do this:
1. From the assignment popover – Click the assignment name in the Gradebook header to open a quick-access pop-up for grading and evaluation actions.
2. From the three-dot menu – Click the three-dot icon next to the assignment name to access options for evaluation and assignment management.
Note: Only teachers with Gradebook edit permissions can perform these actions. Options appear disabled with a tooltip if your access is view-only.
Evaluate student work
You can record grades in the assessment gradebook in different ways - apply them in bulk, navigate quickly across cells, or open detailed panels for deeper evaluations.
1. Open the ‘All submissions’ page
Open the ‘All submissions’ page directly from the assignment popover.
From here, you can open attachments, provide annotations, and complete evaluations. Once saved, the results automatically reflect in the Gradebook.
2. Quick grading options
For times when you need to enter the same grade for all students or edit grades quickly without viewing the full submission, click the three-dot menu next to the assignment name or beside the assessment tool. Two options are available:
Assign the same grade to all students
Open quick evaluation
Assign same grade to all students
This option allows you to quickly apply the same evaluation across the entire class. You can also override grades for students who have already been graded by clicking on the check box in the bottom left corner. Once ready, click ‘Grade all’ to confirm and apply the grades in bulk.
Open quick evaluation
This opens the evaluation panel, where you can switch between students from the left panel. Use the tabs at the top to navigate between assessment tools, and click ‘Save evaluation’ when you are finished. Students whose grading is done will be marked by a green check box in the left panel.
3. Keyboard navigation for grading
Keyboard shortcuts enable you to navigate the gradebook and apply ratings efficiently. The options vary depending on the rating type:
Dropdown ratings (e.g., scale-based scores):
Press ‘Enter/Return’ to open the dropdown.
Use arrow keys to navigate, then press ‘Enter/Return’ to select.
Alternatively, type the rating label (e.g., “Dev” for Developing).
Use drag handles (bottom-right corner of the cell) to copy the ratings to multiple students.
Number scores:
Click or select the score cell and type the number directly.
Use drag handles (bottom-right corner of the cell) to copy the score to multiple students.
Comment boxes:
Press ‘Enter/Return’ on a comment cell to open the text box.
Type your feedback and press ‘Enter/Return’ again to save.
Use drag-and-release to replicate the same comment across multiple students.
Additional shortcuts that work across rating types:
Copy-paste: Use Ctrl + C / Ctrl + V (Windows) or Cmd + C / Cmd + V (Mac) to duplicate ratings, scores, or comments between cells.
Undo: Instantly revert changes with Ctrl + Z (Windows) or Cmd + Z (Mac).
4. Right panel for detailed grading
You can also view, edit, or add grades at the individual student level:
Click the ‘expand’ button on a student’s cell to open the right-side panel.
This shows the full evaluation details for that assignment, including rubric levels, scores, and comments.
You can update ratings directly from here and use the navigation arrows (or keyboard keys) to move between students or assignments.
Share evaluations
After grading, you can decide how and when results contribute to overall scores and when they are visible to students and families. Your grading progress is always saved automatically, but you retain full control over when the final evaluation is confirmed and when it becomes visible to students and families.
You can manage evaluation statuses in two ways:
1. From the assignment popover
Use the assignment popover to update or modify results:
For one or more students:
Open the assignment popover and expand the student accordion to view all students linked to the task. Each student’s row shows their submission status and current evaluation status.
Click the evaluation status to open a drop-down menu. From here, change the student’s evaluation status.
Note: These changes are applied immediately for the selected student(s) and do not affect others.
For all students:
Click on the evaluation status against the total number of students to open a dropdown and change the status.
2. From the three-dot menu
Use the three-dot menu next to the assignment’s name to make changes to the evaluation status for the entire class.
Understand status types and sharing actions
Each assignment has an evaluation status that determines how grades appear in the Gradebook and when they are visible to students and families.
1. Evaluation pending (default status)
Gradebook impact: Scores are saved but do not contribute to category totals or overall scores.
Visibility: Only teachers can see the provisional grades in the gradebook. Students and families see no results yet.
Available actions:
Mark all as evaluated: Finalizes results so they contribute to teacher-side gradebook calculations.
Mark all as evaluated and share with students and families: Finalizes and makes results visible in one step.
2. Evaluation not shared yet
Gradebook impact: Scores now contribute to category and overall scores for teachers.
Visibility: Students and families cannot see the individual scores or updated overall grade yet.
Available actions:
Share evaluation with students and families: Publishes results and changes status to Evaluation shared.
Mark evaluation as pending: Reverts if further grading changes are needed.
3. Evaluation shared
Gradebook impact: Scores contribute to category totals and overall scores.
Visibility: Both teachers and students/families see the same results in the gradebook.
Available actions:
Mark evaluation as pending: Temporarily unshare results to make updates, then re-share once ready.
Communicate using the gradebook
The gradebook also helps you keep communication lines open. To send a quick message, hover over a student’s name and click the message icon to contact them or their family.
Tip: If you’d like to access more information about the student, click the profile icon next to their name to access their profile page.
Create and manage assignments
The gradebook is built primarily for tracking progress, but it also lets you manage assignments without switching screens. From here, you can create new tasks or make quick adjustments without leaving your current view.
Create an assignment
From the ‘+’ Menu in the Gradebook, you can create new assignments from scratch or import existing ones from your units, the School Library, or the Toddle Library.
Note: For detailed guidance on creating each assignment type, you may refer to our resources on creating a Formative/summative assessments, Learning experiences, or Quick tasks, or a Worksheet.
Manage existing assignments
From the main Gradebook view, there are two ways to manage assignments:
From the assignment popover
From the three-dot menu
Both options let you quickly edit assignments and perform key actions without leaving the Gradebook.
Common actions available in both:
Edit assignment – Update the assignment’s title, instructions, or other details.
Change task type – Switch the assignment’s type (for example, from a Quick Task to a Learning Experience).
Note: The task type for a Worksheet cannot be changed. Switching to a Quick task hides any fields specific to the original task type and removes linked rubrics, learning goals, or evaluations (including scores and rubric-based assessments). This action cannot be undone.Send a reminder – Notify selected students to complete or submit their work.
Tag standards and practices – Link standards or practices to the assignment for curriculum alignment.
Delete – Remove the assignment and its data from the Gradebook. Deleted assignments can be restored from the Bin.
Additional actions:
From the assignment popover –
Make quick updates to the dates an assignment opens on, is due on, or closes on.
From the three-dot menu –
View assignment – Opens the full assignment page with all instructions, resources, and linked tools visible in context.
Edit assign settings – Modify settings such as due dates, submission windows, grading tools, and visibility options.
Copy to other classes – Duplicate the assignment in another class without recreating it from scratch.
Download gradebook data
This feature allows you to export your gradebook data for offline analysis or official records. Click the three-dot menu → Download.
This opens a panel where you can customize your export:
Select grading period(s): Choose one or more grading periods you want to include in the report. The ongoing grading period is selected by default.
Select the assessment tools: Choose the assessment tools you want to include in the download.
Click the ‘Download’ button to save the data as an Excel file on your device.
Frequently asked questions
Q1: Why is my task not visible on the gradebook?
If you have created an assignment but do not see it in your gradebook, it may be for one of the following reasons. Here’s a quick checklist to find out why:
Check if it's still a draft: An assignment must be published to appear in the gradebook.
How to fix: Go to the Assignments tab, and from the left panel, open ‘Drafts’ to find your assignment.
Check your active filters: A filter you've applied for subject, assignment type, or grading period might be hiding the task from your current view.
How to fix: Review the filters at the top of the gradebook and clear any that might be excluding the assignment.
Confirm it has an assessment tool: For a task to appear in the gradebook, it must have an assessment tool, such as a score, rubric, or checklist linked to it.
How to fix: Edit the assignment and add at least one assessment tool.
Check if it’s scheduled for the future: Assignments set to be released at a later date will only appear in the gradebook once they are open for student submissions.
How to fix: This is expected behavior. To confirm the scheduled release date, go to the Assignments tab and open ‘Scheduled’ from the left panel. The task will appear in the gradebook automatically on the date and time submissions are open to students.
Check if it's included in the final grade calculation: Your display settings may be hiding assignments excluded from the final calculation.
How to fix: Go to Configure gradebook views > Display settings and enable the option to show these excluded assignments. These tasks are marked with a ‘⊖’ symbol.
Q2: What happens to a student's progress when they are moved from one class to another for the same subject?
When a student is moved to your class from another class tagged to the same subject, all their progress and assignments from their previous class are automatically transferred and will appear in your gradebook.
You will see a small transfer icon next to the title of any assignment that was created in another class. This symbol indicates that the task originated in a different class but is now part of your gradebook for that student. You typically won’t be able to modify their grades if you do not have access to the class they were created in!
If you wish to hide assignments created in another class from your view, go to Configure gradebook views > Display settings, and disable the option for ‘Show tasks from other classes’.
Q3: What happens when scores or grades are overridden?
Teachers can override calculated scores or grades, provided they have the necessary permissions from the school administrator.
When a score or grade is overridden, the cell displays a flag on the top-right corner distinguish it from system-calculated values.
You can revert at any time by opening the right panel. The original calculated grade (marked in yellow) will be available for selection.
Q4: What does the exclamation mark in the Gradebook mean?
Exclamation marks in the Gradebook indicate that certain information or configurations need your attention. These icons appear in different contexts depending on the issue.
1. Next to a student’s evaluation
An orange exclamation mark appears when a student resubmits their work after it has already been evaluated.
This helps teachers quickly identify submissions that may need to be reviewed again.
2. In the term total column header
An alert icon appears when the total grade visible to students and family members is different from what you see as a teacher.
This occurs when some assignment evaluations have not yet been shared with students and families.
We hope you found what you were looking for. Explore other articles for more!