Classroom Management
Create and manage classes, sections, and rosters to organize students and teachers within your institution.
Overview
The Classroom system in Testify provides a structured way to organize users into classes and sections within an organization. Teachers can create classes, add sections, assign students and teachers, manage roll numbers, and bulk-import students from spreadsheets. Classes serve as the foundation for exam assignments, notifications, analytics, and leaderboard scoping.
Every class belongs to an organization and is associated with an academic year, making it easy to manage year-over-year progression.
How It Works
Creating a Class
- Navigate to Classroom from the teacher or admin dashboard.
- Click Create Class.
- Fill in the required fields:
- Name -- e.g., "Class 10-A" or "Physics Batch 2026".
- Organization -- automatically set to your org.
- Grade -- optional grade level.
- Academic Year -- defaults to the current year.
- Click Create. The class appears in your class list.
Each class name must be unique within the same academic year for your organization.
Adding Sections
Sections allow you to subdivide a class (e.g., Section A, Section B):
- Open the class you want to edit.
- Click Add Section.
- Enter the section name.
- The section is created under the class and can have its own set of students and teachers.
Managing Members
Adding Individual Members
- Open a class or section.
- Click Add Member.
- Select the user from your organization's user list.
- Set the role -- either
studentorteacher. - Optionally assign a roll number (for students).
- Click Add. The member appears in the class roster.
A user cannot be added to the same class/section twice -- the system enforces uniqueness.
Viewing Members
The member list shows:
- Full name, email, and phone number.
- Role (teacher or student).
- Section assignment.
- Roll number (if set).
Members can be filtered by section and role. The list is sorted with teachers first, then students alphabetically.
Removing Members
- Find the member in the class roster.
- Click Remove.
- Confirm the removal. The member is immediately removed from the class.
Bulk Student Import
For large classes, you can import students from a spreadsheet:
- Navigate to Bulk Import (available from the classroom page or admin tools).
- Download the template file (Excel or CSV format).
- Fill in student details: first name, last name, email, phone, class name, and roll number.
- Upload the completed file (supports
.xlsx,.xls, and.csv, up to 10 MB). - The system validates the data and shows a preview:
- Students with valid data are queued for creation.
- Rows with issues (duplicate emails, missing fields) are flagged with error messages.
- Confirm the import. New user accounts are created and students are assigned to the specified class.
Viewing Class Details
Each class card or detail page shows:
- Student count -- number of students enrolled.
- Teacher count -- number of teachers assigned.
- Section count -- number of sections within the class.
- Academic year and grade.
- Created date.
Editing and Deleting Classes
- Edit -- update the class name, grade, or academic year.
- Delete -- remove the class entirely. This also removes all member associations (but does not delete user accounts).
Key Features
Organization Scoping
- All classes belong to an organization (identified by
org_id). - Users can only see and manage classes within their own organization.
- Academic year filtering allows viewing classes for a specific year.
Flexible Roles
| Role | Capabilities |
|---|---|
| Teacher | Create classes, manage members, assign exams to classes, view class analytics |
| Student | View their enrolled classes, access assigned exams and materials |
| Admin | All teacher capabilities plus organization-wide class management |
Class-Based Features
Once classes and sections are set up, they integrate with other Testify features:
- Exam Assignments -- assign exams to specific classes or sections.
- Notifications -- send notifications to all students in a class or section.
- Leaderboards -- class-level leaderboards for gamification.
- Analytics -- view performance analytics at the class level.
- Paper Assignments -- assign papers to class groups.
Query Capabilities
The class member API supports two query modes:
- By class -- list all members of a specific class, optionally filtered by section and role.
- By user -- list all classes a specific user belongs to, showing their role and section in each.
Tips and Best Practices
- Create classes at the start of the academic year and reuse them for all assignments throughout the year.
- Use sections to manage large classes -- it makes exam assignment and notification targeting more precise.
- Assign roll numbers during bulk import to maintain consistency with your institution's records.
- Use the bulk import template -- it ensures the correct column format and reduces errors.
- Clean up classes at the end of the academic year by creating new classes for the next year rather than reusing old ones.
- Assign at least one teacher to each class so someone can manage exams and view analytics.
For Administrators
- Use the organization filter to view all classes across the institution.
- Monitor class sizes to ensure balanced distribution of students.
- Review the bulk import error log to address any failed student registrations.
- Classes are a prerequisite for class-level analytics and comparative reports.
Related Features
- Online Exams -- assign exams to classes and sections.
- Notifications -- send targeted notifications by class.
- Analytics -- class-level performance dashboards.
- Parent Portal -- parents see data scoped to their child's classes.