Skip to main content

Gradebook settings and workflows

Overview​

Gradebook Settings control how grades are calculated and displayed to students and instructors. Settings include Grade Distinctions (the labels or levels used in grade reporting), Bundle Components (how objectives are organized, and the rules attached to them), and Bundle Targets (the quantities that connect each rule to each distinction).

A Grade Bundle is the complete set of targets a student's work must meet to earn one specific grade distinction. Bundles are not something you create directly — each column of the Bundle Targets table is one Grade Bundle. A course with six grade distinctions already has six bundles.

Formerly called

Bundle Components were previously called Grade Benchmarks or benchmark groups. Bundle Targets were previously called Grade Thresholds, and an individual target was a threshold. The Grade Bundles settings area was previously called Grade Calculations. Only the names changed — your existing configuration is untouched.

Before you start​

Access grade calculation settings​

  1. Open your course.
  2. Select Course Settings from the course navigation.
  3. In the left sidebar, select Grade Bundles.
  4. The Grade Bundles area contains three pages:
    • Grade Distinctions
    • Bundle Components
    • Bundle Targets

Configure them in that order. "Grade Bundles" names the output; these three pages are the inputs you configure.

Grade Distinctions​

Grade Distinctions are the labels or levels shown in gradebook cells and student grade reports — for example, letter grades (A, B, C), proficiency levels (Proficient, Developing), or custom labels (Mastered, In Progress, Emerging).

Create or edit a distinction​

  1. From Grade Bundles, select Grade Distinctions.
  2. Enter your distinctions in Specify your grade distinctions, separated by commas (for example A, B, C, D, E, F), or edit an existing distinction card.
  3. Update the label and ordering as needed.
  4. Select Save Changes.

Distinctions appear in the gradebook, on student grade summaries, and as the columns of the Bundle Targets table.

Delete or reorder distinctions​

  • To reorder, use the move controls on the distinction card. Order matters: the lowest distinction is the fallback grade.
  • To delete, select the distinction and confirm deletion (ensure no students currently hold that distinction to avoid data issues).

Bundle Components​

Bundle Components are collections of learning objectives that together contribute to a grade — an aspect of learning such as Curriculum, Quality, or Attendance. Each component shows a set of proficiency level counts in the gradebook and holds the Bundle Rules that grades are evaluated against.

Bundle Components and Bundle Rules belong to the course and are shared by every grade bundle. Only the targets differ from one bundle to the next.

Create a Bundle Component​

  1. From Grade Bundles, select Bundle Components.

  2. Add a component and enter:

    • Group Name (for example, "Content Knowledge" or "Communication Skills")
    • Linked Objectives (select the objectives that belong to this component)
    • Proficiency Scale and any attempt-limiting options your course uses
  3. Under Set Bundle Rules:, select Add Bundle Rule and complete the sentence from its dropdowns:

    At least ___ % of a student's marks must be Exemplary.

    Each italicised part is a dropdown, and a fourth dropdown after the proficiency level can widen the rule to or better or or below.

    The quantity that fills the blank counts the student's marks in this component: a share of them when the unit is %, a plain number of them when the unit is #. That quantity is never a score on any single mark — a mark is a proficiency level, not a number.

    The blank is deliberately empty here. The value that fills it is different for each grade distinction, and you set those values on the Bundle Targets page.

  4. Select Save.

The component now appears as a column section in the gradebook, and each of its rules becomes a row on the Bundle Targets page.

Edit or delete a Bundle Component​

  • Edit: Select the component and update objectives, name, rules, or settings; select Save.
  • Delete: Use Delete Bundle Component and confirm. Once deleted, it no longer appears in gradebook calculations, and its rules disappear from Bundle Targets.
  • Mark as not included in grade calculations: A component can be present but excluded from the final distinction — useful when you want to track a skill separately.

Bundle Targets​

Targets are the specific quantities that determine which Grade Distinction a student's work meets for each Bundle Rule.

The page is a table: rows are Bundle Rules, columns are Grade Distinctions. Fill in a cell and you have said what that grade requires of that rule.

Students earn the highest grade for which they meet every rule that applies to it.

Set targets​

  1. From Grade Bundles, select Bundle Targets.
  2. Find the row for the rule you want to set and the column for the grade distinction you are defining.
  3. Enter the quantity that fills that rule's blank for that grade.
  4. Repeat across the column until that grade distinction is fully described — that column is now one complete Grade Bundle.
  5. Select Save.

Leaving a target blank​

Not every rule has to apply to every grade.

Leave blank if this grade doesn't apply to this rule.

A blank means that grade distinction is not considered for that rule — the rule is excluded from that bundle entirely. It is not treated as a target of zero, and it does not make the grade easier or harder to reach; the rule simply is not one of the requirements for that grade.

This is why the combination sentence above says "every rule that applies to it". Two grade distinctions in the same course can be built from different sets of rules.

The lowest grade distinction​

The cells in the lowest grade distinction's column are not editable. That grade is the fallback: students receive it when their work doesn't meet the targets for any other grade distinction, so there is nothing to require.

Typical workflows​

Set up grades for a new course​

  1. Create Objectives and Proficiency Scales in Course Settings.
  2. Create Assignments and link them to objectives.
  3. Create Grade Distinctions (for example letter grades or proficiency labels).
  4. Organize objectives into Bundle Components (for example "Content", "Communication") and add a Bundle Rule to each.
  5. Fill in Bundle Targets one column at a time — each column is one grade.
  6. Record marks on a few assignments; check the gradebook to confirm distinctions appear correctly.
  7. Refine targets if necessary.

Change grade calculation mid-course​

  • Add a new distinction: A new column appears on Bundle Targets with no targets set. Fill it in to define that grade.
  • Exclude a Bundle Component: Affected students' distinctions update as new marks are recorded.
  • Adjust targets: Updates apply immediately; existing students' distinctions recalculate.
  • Blank out a target: That rule stops applying to that one grade. It keeps applying to every other grade whose target is still filled in.

Troubleshoot grades not showing​

  1. Check that Objectives and Proficiency Scales exist.
  2. Verify Assignments are linked to objectives.
  3. Confirm Grade Distinctions are created.
  4. Ensure Bundle Components include the objectives you've marked.
  5. Check that Bundle Targets are filled in for the distinctions you want to award. A grade with no targets anywhere is not awardable.
  6. If students show ?, mark work in the Bundle Components whose rules that grade depends on.

Target best practices​

  • Set targets after creating at least a few assignments and objectives.
  • Start simple: one Bundle Component, one Bundle Rule. Add complexity once the basic workflow is stable.
  • Read the table by column, not by row — a column is a grade, and reading down it tells you exactly what that grade asks for.
  • Test on a small student group first to verify the distinction assignment makes sense.
  • If students show ? (unknown distinction) in the gradebook, check that your targets match the Bundle Components and marks that actually exist.