Skip to content

Requirement Groups

A Requirement Group is a named list of interchangeable courses. When a student type references a requirement group, the student must be scheduled into at least one course from that group — not all of them. For example, a "World Language" group containing French 1, Spanish 1, and German 1 means the student satisfies the requirement by taking any one of the three.

Access Requirement Groups from Settings → Requirement Groups (available to all roles; editing requires Admin).

When to use Requirement Groups

Use a requirement group when students have a choice between equivalent courses. Common examples:

  • World Language — French 1, Spanish 1, German 1
  • 7th Grade Language Arts — Language Arts 7A, Language Arts 7B (different sections, same requirement)
  • PE / Health elective — PE 7, Health, Adaptive PE

If a student must take a specific course with no alternatives, add it as a Required Course directly on the student type rather than as a group.

Create a Requirement Group

  1. Go to Settings → Requirement Groups.
  2. Click + Add.
  3. Fill in the fields:
Field Description
Group ID A short, unique identifier (for example, world-language-7 or pe-health). Cannot be changed after saving.
Display Name A human-readable label shown in the Validator requirements panel.
Description Optional. Clarifies what the group represents.
Category Core, Required Elective, or Elective. Used for color-coding in the Validator.
Courses Select all courses that satisfy this group. Use the search box to filter by name or course code.
  1. Click Save Group.

Edit a Requirement Group

  1. Click the group in the sidebar.
  2. Modify the name, description, category, or course list.
  3. Click Save Group.

Note

The Group ID is locked after the group is first saved. If you need to rename the ID, delete the group and create a new one, then update any student types that referenced the old ID.

Delete a Requirement Group

Requirement Groups can be deleted from the sidebar by opening the group and saving over it or by removing it from Firestore directly. Before deleting a group, check the Used by section in the editor — it lists every student type and grade that references this group. Remove the reference from those student types first to avoid broken requirements.

Export and Import

Use ⬇ Export to download a spreadsheet of all requirement groups. The file contains one sheet:

  • Requirement Groups — one row per group, with columns for ID, Name, Category, and Courses (pipe-separated course codes).

Use ⬆ Import to bulk-load or update groups from the same format. Existing groups with matching IDs are updated; new IDs are created.

Tip

To migrate requirement groups and student types together, use the combined export from Settings → Student Types, which includes all three sheets (Student Types, Grade Requirements, and Requirement Groups) in the correct import order.