Skip to main content
pdf?stylesheet=default
Blackboard Help

Get Started With Gradebook

Find your way around the Gradebook

Steps in Snap: Course tools > Gradebook

Steps in other themes: Turn editing on > Administration > Course administration > Grades

  • Use the tabs and menu at the top of the page to manage and customize your Gradebook. From here you can change your view, import grades, or set your Gradebook up just how you like it.

    More on setting up your Gradebook

  • Students and gradable items are shown in an easy-to-read table. Students are rows and gradable items are columns. Where the two meet is where you grade a student for a specific assignment. Select a cell to enter a grade. Beside each student and gradable item name is an action icon that allows you to perform quick and common actions to the student or item. For example, you can send a message to the student or bulk grade everyone for a single item.

    More on entering grades

  • Filter your view by category or members in a group.

Remove the clutter

Steps in Snap: Course tools > Gradebook > Hide uncategorized

Steps in other themes: Turn editing on > Administration > Course administration > Grades > Joule Gradebook > Hide categorized

Select Show uncategorized items or Hide uncategorized items to show and hide uncategorized items. This can streamline the Gradebook and make it less cluttered. You can customize what is displayed, only showing category totals, or showing all items.

You need to create grade categories and add them to any items you want to grade. If no grade categories are created and used, all you'll see for each student is there course total.

More on grade categories


Set up your Gradebook

Setting up your Gradebook is simple.

  1. Begin setting up your Gradebook by adding gradable activities to your course. Choose the activity you want to add and set the grade settings.
  2. Add grade items to the Gradebook for any offline activities.
  3. Organize your Gradebook with categories. Categories can help you manage the appearance and calculation of grades.
  4. Set how you want grades to be calculated and assign weights.
  5. Set your Gradebook preferences.

Want to know how the Gradebook interacts with other features in your course? Jump to How Gradebook interacts with your course.


Add grade items to the Gradebook

Steps in Snap: Course tools > Gradebook > Setup > Add grade item

Steps in other themes: Turn editing on > Administration > Course administration > Grades > Setup > Add grade item

Not all assessments happen in your Moodlerooms course. You may have "offline" activities, such as oral presentations. Keep grades for all assessments in one place. Add the activities to your Gradebook. When the activity is complete, enter the grades in the Gradebook manually. The grades are available to students and added to the course total.

  1. From Setup in the Gradebook, select Add grade item.
  2. Type a meaningful name for the item.
  3. Select a type from the Grade type menu.
    • Value: Use a numerical value for grading. Type the Maximum grade and Minimum grade that can be earned.
    • Scale: Use a scale to grade. Select the scale you want to use from the Scale menu.
    • Text: Use text to give your students feedback only.
  4. Select how you want the grade to appear in the Grade display type menu.
    • Real: Show the actual grade.
    • Percentage: Show the grade as a percentage.
    • Letter: Show the grade as a letter that represents a range of grades.
  5. Optionally, set the following.
    • Overall decimal points: Set the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.
    • Hidden: Hide the grade for this item from students. If you want to show students the grade for this item later, select a date from the Hidden until menu.
    • Locked: When selected, the item can't be automatically updated by related activity. You can set a date for when you want to lock the grade in.
    • Weight adjusted: Uncheck this to reset a grade item weight to its automatically calculated value. Checking this will prevent the weight being automatically adjusted.
  6. Optionally, type a value for the Weight.
  7. Select Save changes.

Use categories to organize your Gradebook

Steps in Snap: Course tools > Gradebook > Setup > Add category

Steps in other themes: Turn editing on > Administration > Course administration > Grades > Setup > Add category

Categories are used in the Gradebook to group gradable items. This can make the Gradebook easier to view. You can filter your Gradebook view by category. You can also use categories to combine grades, drop the lowest grade, and weight a group of grades.

More on grade categories

To get the most out of categories you must add them to your gradable activities. From the activity settings, expand Grade and select the category from the Grade category menu.


Set aggregation method and assign weights

Steps in Snap: Course tools > Gradebook > Setup

Steps in other themes: Turn editing on > Administration > Course administration > Grades > Setup

By default your Gradebook is set to calculate grades using the Simple weighted mean of grades. This aggregation method does not allow instructors to assign a weight for specific assessment activities. You can change how the Gradebook calculates grades.

  1. From Setup in the Gradebook, select Edit beside the course name.
  2. Select Edit settings.
  3. Select the grade calculation method from the Aggregation menu. Select Weighted mean of grades, if you want to use your own weighted grading scheme.

    More on each grade aggregation method on the Moodle website (may be available in English only)

  4. Select Save changes.

After you have set the aggregation method, you can now assign weights to your Gradebook items and categories. A weight column appears in the Gradebook Setup. Type the weight for each item and category.

Your weights should total 100 to make sure the grade displayed is accurate.


My preferences

Steps in Snap: Course tools > Gradebook > Preferences: Joule Gradebook

Steps in other themes: Turn editing on > Administration > Course administration > Grades > Preferences: Joule Gradebook

Decide what you want to see in your Gradebook.

  • Show/hide Toggles
    • Show calculations: A calculator icon appears for each grade item and category. There are tool tips over calculated items and a visual indicator that a column is calculated. You must select Turn editing on to see it.
    • Show show/hide icons: Use the show/hide icon to show or hide the grade from students. You must select Turn editing on it see it.
    • Show column averages: An additional row appears with the average (mean) for each category and grade item.
    • Show locks: Control if an item can be automatically updated by related activity. Select the lock to lock the grade. Unlock to allow automatic updates. You must select Turn editing on to see it.
    • Show user profile image: See user profile images beside their names.
    • Show ranges: An additional row appears with the range for each category and grade item.
  • Special Rows
    • Range display type: Display ranges as real grades, percentages, or letters.
    • Decimals shown in ranges: Display the number of decimal points for each range.
    • Column averages display type: Display the average (mean) as real grades, percentages, or letters.
    • Decimals in column averages: Display the number of decimal points for each average.
    • Grades selected for column averages: Decide if you want to include cells with no grade when calculating the average (mean) for each category or grade item.
    • Show number of grades in averages: Display the number of grades used when calculating the average (mean) in brackets after each average.
  • General
    • Students per page: Set how many students you want to see on each page of the Gradebook.
    • Aggregation position: Decide where the category and course total columns are displayed in the gradebook reports.
    • Enable AJAX: Adds a layer of AJAX functionality to the Joule gradebook. This simplifies and speeds up common operations. Javascript must be switched on at the user's browser level. This option is set to Yes because AJAX is required for Joule gradebook.

How Gradebook interacts with your course

The Gradebook interacts with several tools and components in Moodlerooms. Understanding how and where these interactions happen can help you take full advantage of this tool.

Gradebook interactions
Tool/Component Interaction
Activities and resources When you create gradable items in your course it adds a grade column for that item to the Gradebook.

Example: When you create a journal, you can select the grading option. A grade column is added to the Gradebook with the name of the journal.

Email tool You can use the email tool in the Gradebook to send messages to students and, if applicable, their observers.
External data from other grading systems You can export and import data to the Gradebook by uploading and downloading delimited files.
Joule Grader You can view and grade submitted assignments and posts made to advanced forums. Grades assigned in the Joule Grader appear in the Gradebook.
Observers Observers can log in and access their observed students' released grades. Examples of observers might include a student's parents or guardians, or a tutor.

Your institution controls observer access. If allowed institution-wide, you can determine observer access on a course-by-course basis.

Student view of grades By default, students see their grades in their own personal Gradebook. You can hide their Gradebook from them in course settings. You can also hide individual grades by column, if you want.
X-Ray Learning Analytics X-Ray extracts and analyzes information from the Gradebook to keep you informed on how your students are doing.

X-Ray also suggests grades for forums but doesn't save those grades to the Gradebook. Teachers must add the grades manually, if they agree with the suggested grade.