Adjust Settings and Preferences

The main view of your gradebook is called the Grader Report.

The gradebook collects assignments (called items) that have been added to your online course, and allows you to view, manually grade, and sort these items into categories to calculate totals in various ways.

When you add an assessed item (such as an assignment) in your course, the gradebook automatically creates a column in the gradebook and also adds the grades themselves as they are generated, either by the system (i.e. when you use the Quiz module) or by you, when you mark an assignment.


To access your course Grades, you must select it within the Administration block of the particular course.

When you enter the grader report for the first time, there will not be much in it, as it provides the basic gradebook with your enrolled students, but nothing more.

Tabs Overview

Tab Navigation

One of the first things you will notice are the tabs running across the top of the grader report.

The View tab: You will primarily use the Grader report view default (showing your full gradebook). Of interest to you may also be the User Report where you can select a student and see what they would see when viewing their grades. 

The Setup tab (see more below): Use this tab to setup or edit grade items in your grade book. This is also where instructors can change aggregation methods and configure viewing preferences for various Report pages.

The Scales tab: allows the instructor to see the default scales for the course.

The Letters tab: allows the instructor to view the defined system Letters (A, B, C …)

The Import tab: allows the instructor to import grades to CourseSpaces (BUT you must be able to export the gradbook first)

    • Be extremely careful when using this import function. If grades are imported incorrectly, the instructor will run the risk of making the gradebook unusable.
    • Grade import is equivalent to manual grading in the grader report. If grades for a particular CourseSpaces activity such as an assignment are imported, they can no longer be edited via the assignment submission page.

The Export tab: allows the instructor to export grades from CourseSpaces.

We advise all instructors to download their gradebook marks to their own computers on a regular basis. This will serve as a backup in case your online version is corrupted in any way.

Categories and Items (Setup Tab)

The Categories and items tab allows the instructor to:

  • Organize the CourseSpaces activities into gradebook categories.
  • Create gradebook items (those are non-CourseSpaces activities that the instructor wants to add to the gradebook - e.g. an in-class presentation).
    • To add a grade item, click 'Add grade item' at the bottom of the page.
    • To add a category click 'Add category' at the bottom of the page.
  • Assign weights to the categories, and set the aggregation method.

Course Grade Settings (Setup Tab)

The Course Grade Settings tab within Setup determines how the gradebook and reports appear for all participants in the course, including students.

General Settings

Aggregation position (Last): Determines where the total column appears on the User Report and at the Categories and items tab. If you put it to First, then all totals will be shown on top of the categories.

Min and max grades used in calculation (default): Determines whether to use the initial minimum and maximum grades from when the grade was given, or the minimum and maximum grades as specified in the settings for the grade item, when calculating the grade displayed in the gradebook.

Grade Item Settings

Grade display type (Real): All grades are shown in this kind of format. You can switch the default for your gradebook.

Overall decimal points (2): This setting specifies the number of decimal points to display for each grade, and is set to 2 by default. You can change this default for your gradebook. This setting has no effect on grade calculations, which are made with an accuracy of 5 decimal places.

Overview Report

This is no longer available

User Report

Show Rank (Hide): Determines whether to show the position of the student in relation to the rest of the class for each grade item.

Show percentage (Show): Determines whether to show the percentage value of each grade item.

Show Grades (Show): Determines whether students can see their grades.

Show Feedback (Show): Determines whether students can see feedback provided by the instructor.

Show Weightings (Show): Determines whether grade item weightings are visible to students.

Show Average (Hide): Determines wheither average grades are visible to students. Students may be able to estimate other student's grades if the average is calculated from a small number of grades. For performance reasons the average is approximate if it is dependent on any hidden items.

Show Letter Grades (Hide): Determines whether percentage grades are displayed as Letter grades.

Show Contribution to Course Total (Show): Determines whether to show a column of percentages indicating how much each grade item contributes to the user's course total percentage (after weighting is applied).

Show Ranges (Hide):

Range Decimal Points (0):

Show Hidden Items: Determines whether hidden grade items are hidden entirely or if the names of hidden grade items are visible to students.

Hide Totals if They Contain Hidden Items (Hide): This setting specifies whether totals which contain hidden grade items are shown to students or replaced with a hyphen (-). If shown, the total may be calculated either excluding or including hidden items. If hidden items are excluded, the total will be different to the total seen by the teacher in the grader report, since the teacher always sees totals calculated from all items, hidden or unhidden. If hidden items are included, students may be able to calculate the hidden items.

Preferences: Grader Report (Setup Tab)

Within grades, the My preferences tab enables instructors to set how the grader report is displayed to them (not students).
It is recommended that you keep most of these at the default setting.

Show/hide toggles:

  • Show Calculations (No): If enabled, when editing, a calculator icon is shown for each grade item and category with a visual indicator that a grade item is calculated.
  • Show show/hide icons (Yes): Displays “eye” icons on the grader report in editing mode.
  • Show column averages (Yes ): Show the average of all grades for each column in an additional row at the bottom of the grader report.
  • Show locks (No): Displays “lock” icons on the grader report in editing mode.
  • Show user profile images (No)
  • Show user idnumber (No): If set to Yes, shows student IDs in a separate column in the Grader report.
  • Show activity icons (Yes): Displays “activity” icons in the column heading.
  • Show ranges (No): Show the range of grades for each column in an additional row at the bottom (example: 0-100 points).
  • Show Grade Analysis Icon (Yes): If the activity module supports it, the grade analysis icon links to a page with more detailed explanation of the grade and how it was obtained.

Special Rows:

  • Range display type (Inherit): Shows the range at the bottom as Real, Percentage, or Letter. We advise you not to use Letter (see FAQ)
  • Decimals shown in ranges (Inherit): Number of decimal points to display for a range. This setting may be overridden per grading item.
  • Column averages display type (Inherit): Specifies how to display the mean for each column.
  • Decimals in column averages (Inherit): Number of decimal points to display for a mean.
  • Grades selected for column averages (Non-empty Grades): You can include empty grades into the calculation of the mean for a column.
  • Show number of grades in averages (No): If you wish, you can show how many grades were included in the calculation of the average.


  • Quick Grading (Yes): Allows the grader to see fields and enter grades manually.
  • Show Quick Feedback (No): Allows the grader to see text fields and type feedback manually.
  • Students per page (x)This setting determines the number of students displayed per page in the grader report.
  • Aggregation Position (Last): This setting determines whether the category and course total columns are displayed first or last in the gradebook reports.
  • Show only Active Enrolments (Yes): This setting determines, if only active enrolled users will be visible in gradebook report. If enabled suspended users will not be shown in gradebook.
  • Enable AJAX (Yes): Adds a layer of AJAX functionality to the grader report, simplifying and speeding up common operations. Depends on Javascript being switched on at the user's browser level.