Skip to main content
UNSW Sydney Logo
Teaching
Mobile search
mobile nav menu button
  • About
  • Teaching
    • New to teaching
    • Educational design
    • Assessment and feedback
    • Evaluating education
    • More...
  • Educational Technology
    • Support
    • Training
    • TELT Administrator
  • Events & News
    • Upcoming events
    • Recent news
    • Event recordings & resources
    • Subscribe to education news
  • Awards
    • Awards
    • Fellowships
    • Gathering evidence of your teaching practice
  • Professional Development
    • Beginning to Teach (BTT)
    • Teaching Accelerator Program
    • Foundations of L&T (FULT)
    • Course Design Institute (CDI)
    • Self-paced learning
    • Academic Mentoring
    • More...
  • Contact & Support
  • About
  • Teaching
      1. New to teaching
      2. Educational design
      3. Assessment and feedback
      4. Evaluating education
      5. More...
  • Educational Technology
      1. Support
      2. Training
      3. TELT Administrator
  • Events & News
      1. Upcoming events
      2. Recent news
      3. Event recordings & resources
      4. Subscribe to education news
  • Awards
      1. Awards
      2. Fellowships
      3. Gathering evidence of your teaching practice
  • Professional Development
      1. Beginning to Teach (BTT)
      2. Teaching Accelerator Program
      3. Foundations of L&T (FULT)
      4. Course Design Institute (CDI)
      5. Self-paced learning
      6. Academic Mentoring
      7. More...
  • Contact & Support

Breadcrumb

  1. Teaching
  2. Technologies
  3. Educational Technology
  4. Moodle
  5. Build Courses in Moodle
  6. Build Your Moodle Course
  7. Assessment Tools
  8. Gradebook

Customise the Gradebook in Moodle

Overview

This page tells you how to add grade categories and grade items in the Moodle Gradebook, as well as how to add weightings to categories, add new scales, change the value of letter grades and create a Gradebook "outcome".

A grade item is a container for a mark awarded for a student's performance in an assessable activity. Grade items are automatically created when you create an assessable activity in Moodle, but you can also create new grade items in the Moodle Gradebook for activities conducted offline.

Grade items can be organised into grade categories (e.g. Quizzes, Exams, Assignments). Grade categories have a hierarchical structure; categories can be nested inside categories in the same way as folders are nested within other folders on a hard drive.

For every grade category, an aggregated (total) grade is calculated from the grade items. You can specify how the grade items within each category will be aggregated—for example, whether grade items will all have the same weight or whether each will be weighted differently.

When to use

It is good practice to set up the Gradebook categories the way you want them at the beginning of the semester. If grade categories have already been set up, you will be able to specify, whenever you create a new assessable activity, which grade category you want the associated grade item to belong to.

Creating grade categories early clarifies in your own mind how the different assessment activities will be weighted in your students' final mark, and  makes students' progress easy to monitor.

Benefits

Once the course starts, as the students complete each assessable activity and you continue to add grade items, your Gradebook will grow. It's important to have it laid out clearly, in logical categories, so that you can interpret and add to it efficiently.

Organising grade items into categories is also vital if you are going to be using the Gradebook to aggregate your students’ final course grades.

Guide

Getting started

Before you begin adding categories and items to the Gradebook, compile a list of:

  • the major types of activities that will contribute to your students' final marks (laboratories, presentations, quizzes etc.)
  • the gradable activities (online and offline) for each activity type.

This will give you an idea of the basic structure that would be ideal for your course's Gradebook—which activities should be listed together and how they contribute to aggregate marks.

Step by step instructions

  • Add a new category
  • Assign weightings to grade items and categories
  • Add a new grade item
  • Add a category with activity score not included in total
  • Enable quick grading and/or quick feedback
  • Mark a manual grade item
  • Move items between categories
  • Add a new scale
  • Change the value of letter grades and link a grade to them
  • Create an outcome

Add a new category

Categories are useful for ordering the Gradebook for a course containing numerous assessable items. You can display Gradebook details for a single category, and you can give each category a weighting, depending on its importance to the overall assessment.

Placing grade items in categories:

  • makes grading easier
  • allows you to obtain category totals (e.g. totals for all quizzes, assignments or group work) automatically
  • makes it possible for you to assign a weighting to those categories.

To add a new category:

  1. Click Turn editing on.
  2. To access the Grader report, open any course page, and in the Settings block, under Course administration, select Grades.
  3. Select the Setup tab in the top row and the Gradebook setup tab in the bottom row of tabs if they are not already selected.

Gradebook customise 2

  1. At the bottom of the page, click Add category.

Gradebook customise 3

  1. On the Grade category page, click Show more to make all the page sections visible, then:
    • Enter a Category name.
    • Complete the Aggregation specifications, using the Help button to help you make your choices. These fields determine how the category total will be calculated.

Gradebook customise 4

  1. Under Category total, click Show more at the bottom of the page section, then:
  • Enter a Category total name (e.g. "Quiz total")if you are likely to put several assessments into the category\
  • Enter Item info and an ID number if necessary. (See the Moodle Docs Grade calculations page for more help with ID numbers.

  1. Complete the Grade type and associated fields as appropriate, clicking the Help button  for assistance if you need it.

  1. Select the Grade display type and Overall decimal points, if you are not using the defaults for those fields.

  1. Select whether to hide or lock the grades, adding a release date if necessary. (Hiding a grade keeps it invisible to students, and prevents it being counted in calculations.)

  1. If necessary, select a Parent category and weighting.

  1. Click Save changes.

 

Assign weightings to grade items and categories

Click the following link to view a video about using grade weightings in the Moodle Gradebook.

Please note course totals will be hidden by default and instructors are advised NOT to unhide them.

To calculate course totals:

  1. In the Gradebook setup, Click Edit settings beside the main course category

    Clicking on 'Edit settings' button in 'Edit' menu beside course grade category
  2. Click on the Aggregation dropdown.

    Aggregation dropdown including 'Weighted mean of grades' and 'Simple mean of gardes'

    For an explanation of the available aggregation types, click the Help button next to the Aggregation column heading. Weighted mean of grades, Simple weighted mean of grades and Sum of Grades are the most commonly used methods of aggregating marks for a course. If you want to use:
    • Weighted mean of grades, continue to the next step.
    • Simple weighted mean of grades or Sum of Grades, go to step 3.
       
  3. Select Weighted mean of grades, then in the Weight column enter each category's weighting in relation to the final course grade. Note: 30.00 = 30%. Make sure the weightings add up to 100%.
  4. Select Simple weighted mean of grades or Sum of Grades, then in the Max. grade column enter the maximum mark each category can earn. Make sure the Course total is a figure you can work with.

To calculate category totals:

  1. In the Gradebook setup, Click Edit settings beside a course category

    Clicking on 'Edit settings' button in 'Edit' menu beside course grade category
     
  2. Click on the Aggregation dropdown. Select the aggregation type appropriate to that category. For an explanation of the available aggregation types, click the Help button  beside to the Aggregation dropdown.

    Aggregation dropdown including 'Weighted mean of grades' and 'Simple mean of gardes'
  3. Complete the fields in the Weight or Max. grade columns, within each category, as you did for course totals in steps 2 or 3.
  4. When you have assigned all the weightings, click Save changes.

    Clicking on save changes button
     

Add a new grade item

Sometimes you need to manually add a grade item to the Gradebook. A grade item is an assessable activity generally conducted offline, for which you want the mark included in a student’s Moodle grades.

You don’t need to create a grade item for assignments. Create an Assignment activity and it will be automatically included in the Gradebook. You can create an assignment that doesn't require student submissions, and that isn't visible to students. These can better prevent data loss, provide better mechanisms for notifying students and be generally easier to manage than manually inserted columns in the Gradebook.

To add a new grade item:

  1. In the Gradebook, select Setup > Gradebook setup.


     
  2. On the Gradebook setup page, scroll to the bottom of the page and click Add grade item.


     
  3. On the Grade item page:
    • Click Expand all if necessary to make all the available page sections visible.
    • At the bottom of the Grade item section, click Show more to make all the available fields visible.
    • Enter an Item name.
    • Add Item info about the grade item. This information will not display anywhere else.
    • Set an ID number so that you can identify the activity when it is included with others in a custom mark calculation. If you're not defining custom calculations methods, you can leave this field blank. (See the Moodle Docs Grade calculations page for more help with ID numbers.)
    • Select the Grade type. Your choices are None, Value (a numerical value with a maximum and minimum), Scale (an item in a list) or Text (feedback only). Only Value and Scale may be aggregated.
    • If you selected Value or Scale, complete the Scale, Maximum grade, Minimum grade and Grade to pass fields as appropriate.
    • Select the Grade display type (Real (actual grades), Percentage and/or Letter grades can be shown).
    • If you selected Real or Percentage, select the Overall decimal points you want displayed.
    • Select whether you want the marks Hidden from students. If necessary, at Hidden until, click Enable and add a release date.
    • Select whether you want the marks Locked so that they cannot be updated by the related activity. If necessary, at Lock after click Enable and add an locking date.
    • Under Parent category, to include this item in an existing Grade category, select the category from the drop-down list. (You can change this later if you need to.)


       
  4. Click Save changes.


     

Add a category with activity score not included in total

Sometimes instructors might need activity scores to be displayed within the Gradebook but not included in the course total. 

This can be achieved by creating a new customised category within the grade book.

Steps to create this category,

  1. Within the Gradebook setup page, create a category with default setttings. 

    ty
     
  2. In the Category total section set the Maximum grade to 0. 


     
  3. Add the assessment which do not need to be included in the total into this Category.

    ergdf
     

All activities within this Category will be worth 0% and not added to the final score. 

Enable quick grading and/or quick feedback

With quick grading and quick feedback, the Grader report displays with editable boxes for each grade, so you can enter or change many at once. This can save you a lot of time when marking, but it's important to remember to save regularly while you quick-mark. By default, quick grading is enabled and quick feedback is not.

To enable quick grading and/or quick feedback:

  1. In the Grader report, in the Settings block, select Grade administration > Setup > Preferences: Grader report.


     
  2. On the Grader report preferences page, below General, in the Quick grading and Show quick feedback drop-down lists, select Yes.


     
  3. Click Save changes.


     

Mark a manual grade item

These instructions are for marking manual grade items if quick grading/feedback has not been enabled.

To add marks to the Gradebook for a manual grade item:

  1. In the Gradebook Grader report, click Turn editing on at the upper right of the page.
  2. To add a mark, click the edit grade icon  within the relevant cell and enter the student's grade and feedback.

  3. On the Edit grade page, you can amend the Final grade, Exclude this mark from aggregations, Hide or Lock it, and add Feedback. When you have made your changes, click Save changes to return to the Grader report.

Move items between categories

Moving items and categories does not affect individual assignment grades, but it does affect aggregations. Follow these instructions to move items from one category to another.

Add a new scale

A scale is an ordered list of marks or text values, ranging from negative to positive (e.g. "Sub-standard, Less than satisfactory, Satisfactory, Good, Very good, Excellent!”), that can be used as a marking strategy for an assessment task.

To add a new scale:

  1. In the Gradebook, in the Settings block, under Grade administration, click Scales.


     
  2. On the View page, click Add a new scale.


     
  3. On the Add a scale page, enter a Name for the scale.


     
  4. Enter the Scale terms, from most negative to most positive, each term separated from the next by a comma.


     
  5. If you need to, add more text in the Description text editor.


     
  6. Click Save changes. The scale displays in the View page under Custom scales, where you can edit or delete it. It also displays as a grading option when you configure an activity.


     

Change the value of letter grades, and link a grade to them

To change the value of letter grades:

  1. In the Gradebook, in the Settings block, under Grade administration, click Letters.


     
  2. On the Grade letters page, click Edit grade letters.


     
  3. On the Edit grade letters page, if this is the first time these letters have been edited, click Override site defaults.


     
  4. Change the letters and the percentages in the Grade letters fields.
  5. Click Save changes.


     

To link a grade item to the changed letter grades:

  1. In the Gradebook, select Setup > Gradebook setup.


     
  2. On the Gradebook setup page, click the Edit settings for the appropriate grade item.


     
  3. On the grade item's editing page, in the Grade item section, click Show more. When further fields display, at Grade display type, select Letter or the desired combination of letters, percentages and numerical values.


     
  4. Click Save changes.


     

Create an outcome

To create an outcome (competency or goal) for a course or activity:

  1. In the Gradebook, in the Settings block, under Grade administration, click Outcomes.


     
  2. On the Outcomes page, click Edit outcomes.


     
  3. On the Edit outcomes page, click Add a new outcome.


     
  4. On the Add an outcome page, enter a Full name and a Short name for the outcome, and select or create a Scale to be associated with it. Add any necessary Description, and click Save changes.


     
  5. The Custom outcomes page displays, where you can edit or delete individual outcomes, or export all outcomes for use in another course.


     

N.B. Moodle will produce a warning message if you attempt to leave Gradebook with unsaved changes.

Additional information

External resources

Click here to view a video about using grade weightings in the Moodle Gradebook.

Further assistance

If you experience technical or other issues, consult the Where to get help page.

  • Educational Technology
    • Moodle
      • Login
      • Dashboard
      • Build Courses in Moodle
        • Orientation to Moodle
        • Request Course through myUNSW
        • Build Your Moodle Course
          • Course Design
          • Course Home Page
          • Adding Course Content
          • Assessment Tools
            • Assignments
            • Quiz
            • Gradebook
              • View the Gradebook
              • Customise the Gradebook
              • Change Gradebook Viewing Preferences
              • Hide Grades from Students
              • Manage Assignments in the Gradebook
              • Upload Grades from Excel to Moodle
              • Export Gradebook Marks, Mark Offline and Re-import
              • Reports
              • Give Feedback with Quiz Grades
              • Change Marks in the Gradebook
              • Create and Manage an Offline Moodle Assignment
            • Create a UNSW Workshop Activity in Moodle
            • Team Evaluation plugin
          • Blackboard Collaborate Ultra
          • Personalized Learning Designer
          • Team Builder
        • Bring Content into your Teaching Instance
        • Facilitate and Deliver Course
        • Uploading grades to SIMS using Astra
      • Course Administration
      • Moodle Releases
      • Moodle Upgrade Project
      • Feature Requests
      • Contacts
      • Index of all support pages
    • Lecture Recording+
    • Turnitin
    • theBox
    • Other eLearning Tools
    • Feature Requests
    • Book a Consultation
    • Digital Media Support & Equipment
    • Immersive Technologies
    • TELT Service Status
    • Known System Issues
    • System Maintenance Windows

Events & news

ChatGPT & AI in our teaching
CEP Lightning Workshops T1 2023
More
Back to top
  • Print
  • Share
    • Facebook
    • Twitter
    • Google
    • Email
  • Home
  • About
  • Educational Technology
  • Events & news
  • Awards
  • Contacts

Authorised by Pro Vice-Chancellor Education
UNSW CRICOS Provider Code: 00098G, TEQSA Provider ID: PRV12055, ABN: 57 195 873 179
Teaching at UNSW, Sydney NSW 2052, Australia Telephone 9385 5989

Footer menu

  • Privacy Policy
  • Copyright & Disclaimer
  • Accessibility
  • Report an incident
  • Complaints
  • Site Map
  • Site Feedback
Page last updated: Friday 18 December 2020