Students
The Students section is where administrators manage courses, learning pathways, student enrollments, badges, and academic progress. It is organized into six sub-tabs.
Permission required: admin_students
Categories
Section titled “Categories”Categories are used to organize courses into groups (e.g., Coding, Robotics, 3D Printing) and are displayed as color-coded labels throughout the curriculum.
Search and New Category
Section titled “Search and New Category”At the top of the Categories tab is a search bar and a button to create a new category:
| Control | What It Does |
|---|---|
| Search box | Filter categories by name. Results update as you type. |
| + New Category | Opens the category form to create a new category (see below). |
A count at the bottom right shows the total number of visible categories (e.g., “3 categories”).
Category Cards
Section titled “Category Cards”Categories are displayed as a grid of cards. Each card shows the category’s color, name, course count, and action buttons.
Each card shows:
| Detail | What It Shows |
|---|---|
| Color dot | The category’s assigned color, displayed as a dot inside a tinted background |
| Name | The category name (truncated if long) |
| Description | Optional description text below the name (up to 2 lines) |
| Course count | Number of courses assigned to this category (e.g., “2 courses”) |
| Edit button (pencil icon) | Opens the Edit Category form |
| Delete button (trash icon) | Deletes the category after confirmation |
Creating & Editing a Category
Section titled “Creating & Editing a Category”Click + New Category to open the category form, or click the pencil icon on any category card to edit it. Both use the same form — when editing, the fields are pre-filled with the current values.
Form Fields
Section titled “Form Fields”| Field | Required | Details |
|---|---|---|
| Name | Yes | The display name for the category (e.g., “Coding”, “Robotics”, “3D Printing”) |
| Color | Yes | Select from 8 preset colors. The selected color is shown with a border and slight scale effect. This color is used for the category dot and badge throughout the app. |
| Description | No | Optional text describing what the category covers |
| Sort Order | No | A number controlling the display order. Lower numbers appear first. Defaults to 0. |
Click Create Category or Save Changes to save. Click Cancel to discard.
Available Colors
Section titled “Available Colors”The 8 color presets are:
Deleting a Category
Section titled “Deleting a Category”Click the trash icon on a category card to delete it.
- Courses that were assigned to the deleted category become uncategorized — they are not deleted.
- Deletion is permanent.
Curriculum
Section titled “Curriculum”The Curriculum tab is where administrators create and manage courses, classes, and workshops. Each entry represents a piece of curriculum that students can be enrolled in.
Search, Filter & Add Course
Section titled “Search, Filter & Add Course”At the top of the Curriculum tab are controls for searching, filtering, and creating new courses:
| Control | What It Does |
|---|---|
| Search box | Filter courses by name, SKU, or description. Results update as you type. |
| Type dropdown | Filter by type — All Types, Course, Class, or Workshop. |
| Status dropdown | Filter by status — All Status, Active, Draft, or Archived. |
| + Add Course | Opens the full course creation form (see below). |
A count at the bottom right shows the number of visible courses (e.g., “5 courses”).
Course Types
Section titled “Course Types”Every curriculum entry has a type that determines its role:
COURSE — A standalone, full-length course. Courses can be parents to classes and workshops.
CLASS — A recurring or scheduled class. Can optionally be linked to a parent course.
WORKSHOP — A one-off or short-format session. Can optionally be linked to a parent course.
Course Statuses
Section titled “Course Statuses”ACTIVE — Available for student enrollment. Shown in enrollment dropdowns.
DRAFT — Work in progress. Not available for enrollment.
ARCHIVED — No longer active. Hidden from enrollment dropdowns but retained for historical records.
Curriculum Table
Section titled “Curriculum Table”Courses are displayed in a sortable table on desktop and as cards on mobile.
Desktop Table Columns
Section titled “Desktop Table Columns”| Column | What It Shows |
|---|---|
| Checkbox | Select courses for bulk actions |
| Name | Course name. Shows “Child of parent course” subtitle if linked to a parent. |
| SKU | The in-house course code (monospace, e.g., FY-STEM-101) |
| Type | COURSE , CLASS , or WORKSHOP |
| Status | ACTIVE , DRAFT , or ARCHIVED |
| Created | Date the course was created |
| Prerequisites | Required course SKUs, or “None” |
| Badge | Completion badge name with icon, or ”—” |
Click any column header to sort ascending or descending. Click any row to open the course detail panel.
Mobile Cards
Section titled “Mobile Cards”On smaller screens, each course displays as a card showing the name, SKU, type badge, status badge, linked badge, and prerequisites.
Creating & Editing a Course
Section titled “Creating & Editing a Course”Click + Add Course to open the course form, or click Edit in a course’s detail panel to edit it. Both use the same full-page form.
Form Fields
Section titled “Form Fields”| Field | Required | Details |
|---|---|---|
| Name | Yes | The display name (e.g., “Introduction to STEAM”) |
| SKU / In-House ID | Yes | A unique code for the course. Auto-uppercased (e.g., FY-STEM-101). |
| Type | Yes | Toggle between Course, Class, or Workshop. Selecting Course clears any parent link. |
| Parent Course | No | Only shown for Class or Workshop types. Link to a parent course, or leave as standalone. |
| Status | Yes | Draft (default for new), Active, or Archived |
| Sort Order | No | Controls display order. Lower numbers appear first. |
| Description | No | Brief course description |
| Duration | No | Estimated time commitment (e.g., “~20 hours”, “8 weeks”) |
| Category | No | Assign a category for grouping. Shows a color-coded preview when selected. |
Learning Objectives
Section titled “Learning Objectives”Add skills and knowledge students will gain from the course. Type an objective and click Add (or press Enter). Each objective appears as a green pill that can be removed with the X button.
Course Curriculum (Sections & Lessons)
Section titled “Course Curriculum (Sections & Lessons)”Build the course structure by adding sections, each containing activities (lessons, projects, or quizzes).
Adding a section:
- Click Add Section at the top of the curriculum builder
- The section expands with fields for:
- Section Title (e.g., “Getting Started”)
- Estimated Duration (e.g., “4 hours”)
- Description
Adding activities to a section:
- Click Add Activity within a section
- Each activity has:
- Type selector — LESSON , PROJECT , or QUIZ
- Title — Activity name
- Duration — Estimated time
- Remove with the X button
Sections are numbered (1, 2, 3…) and can be collapsed/expanded. Click Remove Section to delete a section and all its activities.
Prerequisites
Section titled “Prerequisites”Select courses that students must complete before enrolling. Choose from a dropdown and click Add. Each prerequisite shows as a pill with the SKU and course name.
Completion Badge
Section titled “Completion Badge”Optionally link a badge that is auto-awarded when a student completes the course. Select from the badge dropdown — a preview with the badge icon and name appears when selected.
Saving
Section titled “Saving”Click Create Course or Save Changes to save. Click Cancel to return to the curriculum list without saving.
Course Detail Panel
Section titled “Course Detail Panel”Click any course row in the table to open a detail panel that slides in from the right:
Panel Sections
Section titled “Panel Sections”| Section | What It Shows |
|---|---|
| Header | Course name, SKU (monospace), type badge, status badge, close button |
| Description | Full course description |
| Duration & Category | Duration card and category card with color dot (if set) |
| What You’ll Learn | Learning objectives listed with green checkmarks |
| Curriculum | Sections with numbered badges, lesson/project/quiz pills, and duration |
| Completion Badge | Badge icon and name (if linked) |
| Prerequisites | Required SKU pills |
| Classes | Child classes/workshops linked to this course (if any) |
| Completion Progress | Progress bar with percentage, plus counts: completed, in progress, not started |
| Enrolled Students | List of students with avatar, name, username, and enrollment status badge |
Panel Actions
Section titled “Panel Actions”At the bottom of the panel are three action buttons:
| Button | What It Does |
|---|---|
| Edit | Opens the course form pre-filled with current values |
| Archive (amber icon) | Sets the course status to Archived |
| Delete (red icon) | Deletes the course after confirmation |
Deleting a Course
Section titled “Deleting a Course”Click the delete button in the detail panel to delete a course:
Deleting a course cascades:
- All student enrollments for this course are removed
- All pathway course links referencing this course are removed
- The course itself is permanently deleted
Pathways
Section titled “Pathways”Pathways are ordered sequences of courses that guide students through a structured learning journey. Each pathway defines which courses to complete, in what order, and can optionally award a badge upon completion.
Search and New Pathway
Section titled “Search and New Pathway”| Control | What It Does |
|---|---|
| Search box | Filter pathways by name or description. Results update as you type. |
| + New Pathway | Opens the pathway form to create a new pathway. |
A count at the bottom right shows the number of visible pathways (e.g., “3 pathways”).
Pathway Cards
Section titled “Pathway Cards”Pathways are displayed as a grid of cards (2 columns on desktop, 1 on mobile).
Each card shows:
| Detail | What It Shows |
|---|---|
| Icon | A route icon in the pathway’s assigned color, inside a tinted background |
| Name | The pathway name |
| Description | Optional description text (up to 2 lines) |
| Course pills | Numbered list of courses in order (e.g., “1. Intro to STEAM”, “2. Python Basics”) |
| Course count | Total number of courses in the pathway |
| Student count | Number of unique students enrolled in at least one pathway course |
| Completion badge | Badge name with icon (if one is linked) |
| Edit button (pencil icon) | Opens the pathway form to edit |
| Delete button (trash icon) | Deletes the pathway after confirmation |
| View Progress | Opens the pathway detail panel to see student progress |
Creating & Editing a Pathway
Section titled “Creating & Editing a Pathway”Click + New Pathway to create, or click the pencil icon on a pathway card to edit. Both open the same form modal.
Form Fields
Section titled “Form Fields”| Field | Required | Details |
|---|---|---|
| Name | Yes | The display name for the pathway (e.g., “STEAM to Code”) |
| Description | No | A brief description of what the pathway covers |
| Color | Yes | Select from 8 preset colors. Used for the pathway icon and card accent. |
| Courses (ordered) | Yes | The sequence of courses in the pathway. At least one course is required. |
| Completion Badge | No | A badge auto-awarded when a student completes all courses in the pathway |
Managing the Course List
Section titled “Managing the Course List”- Select a course from the dropdown and click the + button to add it
- Only Active courses that aren’t already in the pathway appear in the dropdown
- Use the up/down arrows to reorder courses
- Click the trash icon to remove a course from the pathway
- Each course shows its name, SKU, and position number
Click Create Pathway or Save Changes to save. Click Cancel to discard.
Pathway Detail Panel
Section titled “Pathway Detail Panel”Click View Progress on a pathway card to open the detail panel, which slides in from the right:
Panel Sections
Section titled “Panel Sections”| Section | What It Shows |
|---|---|
| Header | Pathway name, description, and color icon |
| Summary stats | Three cards: Courses count, Students count, Completed count (green) |
| Course Sequence | Numbered list of all courses in order, with name and SKU |
| Completion Badge | Badge name in amber highlight (if linked) |
| Enroll in Pathway | Dropdown to select a student and enroll them in all pathway courses at once |
| Student Progress | List of enrolled students with progress bars and completion counts |
Student Progress
Section titled “Student Progress”Each student row shows:
- Avatar with initials
- Name
- Progress bar — fills based on completion percentage (blue while in progress, green at 100%)
- Completion count (e.g., “2/4”)
- Expand arrow — click to see per-course status breakdown
When expanded, each course shows an icon indicating its status:
- ✓ Green checkmark — Completed
- ◷ Amber clock — In Progress
- ○ Gray circle — Not Started
- ○ Light circle — Not Enrolled
If a student has unenrolled courses, an “Enroll in X remaining courses” button appears to fill the gaps.
Deleting a Pathway
Section titled “Deleting a Pathway”Click the trash icon on a pathway card to delete it.
- Deleting a pathway removes its course links only — the courses and student enrollments are not affected
- Deletion is permanent
Students
Section titled “Students”The Students tab shows an aggregated view of all students with enrollment and badge counts. From here you can enroll students in courses, track their progress, manage individual enrollments, and award badges.
Search, Filter & Enroll
Section titled “Search, Filter & Enroll”| Control | What It Does |
|---|---|
| Search box | Search students by name or username. Results update as you type. |
| Status dropdown | Filter by enrollment status — All Status, Not Started, In Progress, or Completed. |
| + Enroll Student | Opens the enrollment modal to assign a student to a course. |
Student Progress Table
Section titled “Student Progress Table”Students are displayed in a sortable table on desktop and as cards on mobile.
Desktop Table Columns
Section titled “Desktop Table Columns”| Column | What It Shows |
|---|---|
| Checkbox | Select students for bulk actions |
| Student | Avatar with initials, full name, and @username (sortable) |
| Enrolled | Total number of courses the student is enrolled in |
| Completed | Number of completed courses (green) |
| Badges | Badge count with award icon (amber) |
Click any column header to sort ascending or descending. Click any row to open the student detail panel.
Mobile Cards
Section titled “Mobile Cards”On smaller screens, each student displays as a card showing name, username, enrolled/completed counts, and badge count.
Enrolling a Student
Section titled “Enrolling a Student”Click + Enroll Student to open the enrollment modal:
Form Fields
Section titled “Form Fields”| Field | Required | Details |
|---|---|---|
| Student | Yes | Select a student from the dropdown (searches by name and username) |
| Course | Yes | Select an active course from the dropdown (shows name and SKU) |
The modal includes validation:
- Prerequisite warning — If the selected course has prerequisites the student hasn’t completed, an amber warning appears showing the missing SKUs. You can still proceed (admin override).
- Already enrolled — If the student is already enrolled in the selected course, a red warning appears and the Enroll button is disabled.
Click Enroll Student to create the enrollment (starts as “not_started”) or Cancel to close.
Student Detail Panel
Section titled “Student Detail Panel”Click any student row in the table to open the detail panel, which slides in from the right:
Summary Stats
Section titled “Summary Stats”Three stat cards at the top:
- Enrolled — total course enrollments
- Completed — completed courses (green)
- Badges — badges earned (amber)
Courses Section
Section titled “Courses Section”Lists all courses the student is enrolled in. Each enrollment shows the course name, SKU, and status badge, plus action buttons:
| Button | What It Does |
|---|---|
| Complete | Marks the enrollment as completed. Auto-awards the linked badge if one exists. |
| Start | Changes status from “not_started” to “in_progress”. Only shown for not-started enrollments. |
| Revert | Changes a completed enrollment back to “in_progress”. Only shown for completed enrollments. |
| Unenroll | Removes the enrollment entirely. |
Pathways Section
Section titled “Pathways Section”Shows pathway progress for any pathways the student is enrolled in:
- Pathway name with color icon
- Progress bar with completion count (e.g., “1/4”)
- Per-course breakdown with status icons (checkmark for completed, clock for in progress, circle for not started)
- “Enroll in X remaining” button if the student has gaps in a pathway
Badges Earned Section
Section titled “Badges Earned Section”Displays all badges the student has earned in a 2-column grid. Each badge shows:
- Badge icon and name
- Award type (Auto if earned by completing a course, Manual if awarded by an admin)
- Revoke button (X icon on hover) to remove the badge
Footer Actions
Section titled “Footer Actions”| Button | What It Does |
|---|---|
| Enroll | Opens the enrollment modal with this student pre-selected |
| Award Badge | Opens the badge award modal for this student (see below) |
Award Badge Modal
Section titled “Award Badge Modal”In most cases, students earn badges automatically when they complete a course or class that has a linked completion badge — no admin action is needed. This modal is for situations where you need to manually award a badge, such as recognizing an achievement outside of the standard curriculum or correcting a missing badge.
Click Award Badge in the student detail panel footer to open the modal:
The modal shows:
- Student dropdown — pre-selected with the student from the detail panel
- Badge grid — all available badges displayed as cards with their icon and name. Badges the student already has are grayed out with an “Already earned” label and cannot be selected again.
Click Award Badge to manually award the selected badge (recorded as “Manual” award type) or Cancel to close.
Badges
Section titled “Badges”The Badges tab is where administrators create and manage achievement badges. Badges are visual awards that students earn — either automatically when they complete a linked course, or manually when awarded by an admin.
Search, Filter & Create
Section titled “Search, Filter & Create”| Control | What It Does |
|---|---|
| Search box | Filter badges by name. Results update as you type. |
| Filter dropdown | Filter by type — All Badges, Linked to Course, or Standalone. |
| Award Badge | Opens the Award Badge modal to manually give a badge to a student. |
| + Create Badge | Opens the badge creation form (see below). |
A count at the bottom right shows the number of visible badges (e.g., “3 badges”).
Badge Cards
Section titled “Badge Cards”Badges are displayed in a responsive grid (up to 4 columns on desktop).
Each card shows:
| Detail | What It Shows |
|---|---|
| Icon | The badge’s icon or custom image, displayed in a colored circle |
| Name | The badge name |
| Description | A short description of what the badge represents (up to 2 lines) |
| Linked course | A blue pill showing the linked course name, or a gray “Standalone” pill if not linked |
| Awarded count | How many students have earned this badge (e.g., “2 students awarded”) |
| Checkbox | Select badges for bulk actions |
Click any badge card to open its edit form.
Creating & Editing a Badge
Section titled “Creating & Editing a Badge”Click + Create Badge to create a new badge, or click any badge card to edit it. Both open the same form modal.
Form Fields
Section titled “Form Fields”| Field | Required | Details |
|---|---|---|
| Name | Yes | The display name for the badge (e.g., “STEAM Explorer”, “Cura 3D”) |
| Description | No | What the badge represents or how it’s earned |
| Icon | Yes | Choose from 28 Lucide icons displayed in a grid. The selected icon is highlighted in blue. |
| Color | Yes | Select from 10 preset colors. The color is used for the badge icon background and tint. |
| Custom Graphic URL | No | An image URL that overrides the icon. Supports browsing uploaded media from the Media library. Use a square image for best results. |
| Linked Course | No | Select a course to auto-award this badge when a student completes it. Choose “Standalone badge” for badges awarded only manually. |
A live preview of the badge icon appears at the top of the form, updating as you change the icon, color, or custom image.
Click Create Badge or Save Changes to save. Click Cancel to discard.
Deleting a Badge
Section titled “Deleting a Badge”Badges can be deleted from the edit form. Deleting a badge:
- Removes all student badge awards associated with it
- Unlinks the badge from any courses that reference it
- Deletion is permanent
Progress
Section titled “Progress”The Progress tab is a read-only dashboard that shows aggregate completion data across your entire curriculum. It answers the question: “How are students performing across all courses and classes?”
KPI Cards
Section titled “KPI Cards”Four summary cards at the top of the page:
| Card | What It Shows |
|---|---|
| Total Students | Number of unique students with at least one enrollment |
| Total Enrollments | Total number of course enrollments across all students |
| Completion Rate | Percentage of enrollments marked as completed (green) |
| Badges Awarded | Total number of badges earned by all students (amber) |
Course Filter
Section titled “Course Filter”A dropdown below the KPI cards lets you filter the completion table to a specific course or view all courses at once.
Completion Table
Section titled “Completion Table”A table showing completion metrics for every active course and class:
| Column | What It Shows |
|---|---|
| Name | The course or class name |
| SKU | The in-house course code (monospace) |
| Type | COURSE or CLASS |
| Enrolled | Number of students enrolled |
| Completed | Number of students who completed (green) |
| Completion Rate | A progress bar with percentage — fills based on completed vs. enrolled |
Recent Completions
Section titled “Recent Completions”A feed of the most recent students who finished a course, sorted newest first. Each entry shows:
- A green checkmark icon
- Student name completed Course name
- The completion date
- If the course has a linked badge, a colored badge pill appears (e.g., “+Cura 3D”) indicating the badge was auto-awarded
Next Steps
Section titled “Next Steps”- See how students interact with courses in the Student portal
- Review the Dashboard for overall portal metrics
- Learn about FYBIT Credits and how the credit system works