Moodle Gradebook Mastery 2026: Configure Grades That Work First Time

Moodle's gradebook is the most complained-about feature on the platform. Forums fill with posts from instructors whose course totals don't add up, whose weighted categories produce unexpected numbers, and whose grade letters don't match institutional policy. The problem isn't that the gradebook is broken -- it's that it has 8 aggregation methods, 4 display types, nested categories, and dozens of hidden settings, and the defaults rarely match what you actually need.

This guide eliminates the confusion. You'll learn exactly how each aggregation method calculates grades, how to set up categories and subcategories, how to handle extra credit and dropped grades, how to configure grade letters and scales, and how to export grades in the format your registrar requires. The guide ends with three ready-to-use gradebook recipes for K-12, higher education, and corporate training scenarios.

Gradebook Fundamentals: How Moodle Calculates Grades

Before you configure anything, understand what happens behind the scenes when Moodle calculates a course total.

The Grade Hierarchy

Moodle's gradebook works as a tree structure:

Course Total (root)
  |-- Category: Assignments (40%)
  |    |-- Assignment 1 (100 points)
  |    |-- Assignment 2 (100 points)
  |    |-- Assignment 3 (100 points)
  |-- Category: Quizzes (30%)
  |    |-- Quiz 1 (50 points)
  |    |-- Quiz 2 (50 points)
  |    |-- Quiz 3 (50 points)
  |-- Category: Participation (20%)
  |    |-- Forum Posts (30 points)
  |    |-- Attendance (20 points)
  |-- Final Exam (10%, 200 points)

Each graded activity lives inside a grade category (or directly under the course total). The category aggregates its activity grades using a method you choose. The course total then aggregates the category totals using another method you choose. These two levels can use different aggregation methods, though using the same method at both levels is simpler.

The Grader Report: Your Command Center

Navigate to the Grades tab in your course navigation, then select Gradebook setup from the dropdown. The Grader Report is the default view. It shows:

• Columns: One per graded activity, plus category totals and the course total
• Rows: One per enrolled student
• Cells: Individual grades (editable if you have permission)

Toggle between views using the dropdown at the top left:

• Grader report: Full grade matrix (the main view)
• Grade history: Audit log of all grade changes
• Grade summary: Overall grades overview (per course)
• Overview report: Summary of all courses for a student
• Single view: Grade one activity or one student at a time (faster for bulk entry)
• User report: What students see -- their own grades with feedback

Aggregation Methods Explained

The aggregation method determines how Moodle combines individual grades into a category total or course total. Moodle provides 8 aggregation strategies. Here's exactly how each one works.

Method	How It Calculates	Weight Behavior	Best Use Case	Key Advantage
Natural (Default)	Sum of points (can also behave like weighted if weights used)	Based on points or manual weights (optional)	Standard point-based courses	Flexible (points + weights)
Weighted Mean of Grades	Weighted average of percentages	Manual weights	University-style grading	Precise control
Simple Weighted Mean	Mean where max grade acts as weight	Based on max points	When combining Drop Lowest + Extra Credit	Handles edge cases
Mean of Grades	Average of percentages	Equal weight	Equal importance grading	Simple
Median of Grades	Middle percentage value	No weighting	Rare cases	Reduces outlier impact
Lowest Grade	Lowest percentage	No weighting	Competency / must-pass	Enforces minimum performance
Highest Grade	Highest percentage	No weighting	Portfolio / retries	Rewards best attempt
Mean (with Extra Credit)	Mean with extra credit handling	Manual	Legacy only	Backward compatibility

Setting Up Grade Categories

Grade categories are how you organize your course grading. They let you group related activities and control how grades are calculated, weighted, and adjusted.

Creating a Category

Go to Grades -> Gradebook setup -> Add -> Add category, then configure:

• Category name (e.g., "Assignments")
• Aggregation method (Natural or Weighted Mean works for most cases)
• Exclude empty grades = Yes -> This is important -- it prevents students from being penalized for work they haven't submitted yet
• Drop the lowest = N -> For example, set to 1 if you want to drop the lowest quiz score automatically

Nesting Categories (Subcategories)

If your grading structure is more complex, you can create categories inside categories.

Example:

Course Total (Weighted Mean)
  |-- Assignments (weight: 40)
  |    |-- Written Assignments (weight: 60)
  |    |    |-- Essay 1
  |    |    |-- Essay 2
  |    |-- Lab Reports (weight: 40)
  |         |-- Lab 1
  |         |-- Lab 2
  |-- Exams (weight: 60)
       |-- Midterm
       |-- Final

Here's what's happening:

• Written Assignments = 60% of Assignments
• Lab Reports = 40% of Assignments
• Assignments = 40% of the total course grade

To create subcategories, just select the Parent category while creating them.

Moving Items Between Categories

You can reorganize your gradebook anytime:

• Use the Move dropdown next to an item
• Or drag and drop (if your Moodle theme supports it)

Extra Credit

Extra credit lets you reward students without increasing the total possible marks.

How to Set It Up

You can only set extra credit after creating the item:

1. Go to Gradebook setup
2. Click Edit -> Edit settings on the item
3. Enable Extra credit
4. Save

How It Works

In Natural Aggregation

Let's say:

• 3 assignments x 100 points = 300 total
• Extra credit quiz = 20 points A student scoring 100 + 90 + 85 + 20 = 295/300 = 98.33%

Notice:

• The total is still 300
• Extra credit can push scores above 100%

In Simple Weighted Mean

Works similarly -- the extra credit adds to the score, but doesn't increase the total weight.

Important Notes

• Moodle does not cap grades at 100% -- you must set this manually if required.

• You cannot use Drop Lowest + Extra Credit together in Natural aggregation.

Use Weighted Mean or Simple Weighted Mean instead.

Grade Letters and Scales

Grade Letters

Grade letters convert percentages into grades like A, B, C.

• You can configure them from Grades -> More -> Grade letters.

Where they appear:

• Grader Report
• User Report (student view)
• Exported grade files

You can choose how grades display:

• Letter
• Percentage
• Raw points
• Or a combination (e.g., Letter + Percentage)

Using Scales Instead of Points

Scales use descriptive labels instead of numeric grades.

Example: Not Yet -> Approaching -> Meeting -> Exceeding

Creating a Scale:

1. Go to Grades -> Scales -> Add a new scale
2. Enter values from worst to best
3. Save

Using It:

When creating an activity:

• Set Grade type = Scale
• Select your custom scale.

Important: How Scales Are Calculated

Although scales display labels, Moodle converts them into numeric values internally for calculations:

• Each scale item is assigned a position value
• Moodle converts this into a proportional numeric score
• The exact value depends on the aggregation method

Key Behavior:

• In Natural aggregation -> The highest scale value typically maps close to 100%
• In Weighted Mean / Mean of Grades -> Scale values are normalized differently based on percentage calculations

Result: The same scale label can produce different final grades depending on your aggregation method.

When to Use Scales

• K-12 standards-based grading
• Pass/Fail systems
• Participation grading
• Competency-based learning

Hiding and Locking Grades

Hiding Grades

Hidden grades are:

• Not visible to students
• Still included in grade calculations

Use this when:

• You're still grading
• You want to release all grades at once
• The activity is used as a prerequisite or checkpoint

How it works:

• You can manually hide a grade item
• Or use "Hidden until" to automatically release it on a specific date

Locking Grades

Locked grades:

• Cannot be changed manually
• Are not updated by automatic processes (e.g., quiz regrading)

Use this when:

• Grades are finalized
• You're handling grade disputes
• You want to prevent recalculation after changes

How it works:

Lock can be applied to:

• Individual grades
• Grade items
• Categories

You can also use "Lock after" to automatically lock grades from a certain date.

Note: "Cannot be changed" applies to both manual edits and system updates -- not just students.

Grade History and Audit Trail

Moodle keeps a complete log of all grade changes.

Navigation: Grades -> Reports -> Grade history

You can see:

• Who changed the grade
• When it was changed
• Old vs new values
• Source (manual edit, quiz attempt, assignment submission)

Why it matters:

• Resolving grade disputes
• Audit/compliance tracking
• Debugging grade issues

Outcomes and Competencies

Outcomes (Learning Objectives)

Outcomes track specific skills or learning objectives separately from grades.

Example: "Can analyze a dataset"

Setup:

You can create outcomes at either the site or course level:

• Course level: More -> Outcomes
• Site level: Site administration -> Grades -> Outcomes

Steps:

1. Add a new outcome
2. Assign a scale (e.g., Not Yet, Approaching, Meeting, Exceeding)
3. Link the outcome to activities (Assignment, Quiz, etc.)

When Grading:

When grading an activity, you assign:

• A grade (points/percentage)
• An outcome rating (scale value)

This allows you to track performance on specific skills independently of the overall grade.

When to Use Outcomes:

• You want to track specific skills separately from marks
• You need simple skill-based reporting within a course
• You are aligning activities with learning objectives or course goals
• You don't need complex frameworks or cross-course tracking

Competencies

Competencies are broader than outcomes and work across multiple courses. They support:

• Skill hierarchies
• Learning plans
• Evidence portfolios

Setup (Important)

Competencies are configured at the system level: Site Administration -> Competencies -> Competency frameworks

They can then be:

• Linked to courses
• Connected to activities
• Used to track learner progress across programs

When to Use Competencies:

• You need institution-wide skill tracking
• You want to manage learning paths or programs
• You require structured frameworks (e.g., job roles, certifications)
• You want progress tracking across multiple courses

Key Difference

• Outcomes -> simple, course-level tracking
• Competencies -> structured, institution-wide frameworks

Rubrics (Advanced Grading)

If you want more detailed and structured grading, you can use advanced grading methods like rubrics. Rubrics allow you to:

• Define clear criteria for grading
• Maintain consistency across evaluators
• Provide detailed feedback to learners

You can enable and configure rubrics from: Activity settings -> Grade -> Grading method (choose Rubric or Marking guide)

Exporting Grades

Navigation: Grades -> More -> Export

Available Formats

• Excel (.xlsx)
• CSV (plain text)
• ODS
• XML

Export Setup

When exporting, you can:

• Select which grade items to include
• Choose display type: Real (points), Percentage, or Letter
• Set decimal places
• Include feedback comments (optional)

SIS Integration Options

• Manual CSV export/import -> Export grades, format them, and upload to your SIS
• Moodle plugins -> Automate syncing with systems like Banner, PeopleSoft, Workday
• LTI grade passback -> Grades sync automatically when using LTI-integrated tools

Common Gradebook Mistakes and Fixes

1. Empty Grades Showing as 0

Enable: Exclude empty grades

Important:

• An empty grade = no submission / not graded yet.
• A manually entered 0 is treated as a real grade and will still count.

2. Weights Not Adding Up

Moodle automatically normalizes weights.

Example:

40 + 30 + 20 = 90 -> recalculated proportionally

Fix:

• Adjust weights to total 100 (recommended for clarity),
• Or make sure no category/item is missing.

3. Grades Not Updating

Remove manual override (yellow-highlighted cell)

Manual overrides block:

• Quiz regrades
• Assignment updates
• Any automatic recalculation

4. Category Totals Look Wrong

Check your aggregation method

• Mean of Grades -> averages percentages
• Natural -> calculates based on total points

Using the wrong method is the most common cause of "wrong totals."

5. Grades Visible Too Early

Use:

• Hide setting (or "Hidden until")
• Marking workflow (Assignments only)
• Quiz review settings

These help you control when students can see grades.

6. Drop Lowest Confusion

Moodle drops the lowest percentage, not lowest raw score.

Watch out:

• If Exclude empty grades is OFF, empty items may be treated as 0% and get dropped instead of real scores.

Gradebook Recipes

1. K-12 Standards-Based

• Use scales instead of points
• Aggregation: Highest Grade
• Create categories per standard

Example Grade Bands (institution-defined):

• Exceeding: 88-100
• Meeting: 63-87
• Approaching: 38-62
• Not Yet: 0-37

Focus: tracking mastery, not averaging scores.

2. University Weighted Course

Structure:

• Participation: 10%
• Homework: 20% (drop lowest 1)
• Midterm: 30%
• Final: 40%

Setup:

• Course aggregation: Weighted Mean of Grades
• Categories use: Natural aggregation internally
• Display: Letter + Percentage

This is the most common and balanced grading model.

3. Corporate Training (Pass/Fail)

• Aggregation: Lowest Grade
• Each module must be passed (>=80%)

Modules: Policy, Safety, IT, Compliance, Role-specific

Quiz Setup:

• Unlimited attempts
• Highest grade counts
• Randomized questions

Grading:

• Pass: 80-100
• Fail: 0-79

Set using:

• Grade to pass, or
• Grade letters

Completion Rules:

• All activities must be completed
• Final grade must meet pass threshold (>=80%)

Result:

• Fail one module -> fail course.
• Encourages mastery over one-time performance.

How MooDIY Simplifies Gradebook Management

Moodle's gradebook isn't just a grading tool -- it's a heavy, real-time calculation system. For example, a course with 500 students and 40 graded items means 20,000 grade cells recalculated every time the Grader Report loads. On weak infrastructure, that quickly turns into lag and frustration.

Performance at Scale

MooDIY is built to handle this load smoothly. Its optimized database setup and Redis caching reduce repeated queries, so even large gradebooks stay fast -- especially when multiple instructors are working at the same time.

Reliable Backups

Grade data isn't something you can afford to lose. MooDIY's automated backups capture the entire gradebook state, including grade history, at regular intervals -- critical for audits and resolving disputes.

Expert Support

Gradebook issues are one of the most common (and stressful) Moodle problems. MooDIY's support team understands aggregation methods, weights, and edge cases -- so when something looks off right before a deadline, you get help that actually solves it.

---

Ready to get your gradebook right the first time? Start your free MooDIY trial and build your grading structure on infrastructure built for these workloads. See our Moodle analytics and reporting guide for turning your grade data into actionable insights.

Related Articles

Complete your grading strategy:

• Moodle Quiz and Assessment Guide 2026 -- Build the assessments that feed your gradebook
• Effective Moodle Course Design Guide 2026 -- Align your course structure with your grading plan
• Moodle Analytics and Reporting Guide 2026 -- Analyze grade data for student success insights
• Moodle Data Privacy Compliance Guide 2026 -- Privacy requirements for storing grade records

---