Skip to main content

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.

Classroom Management

How It Works​

Creating a Class​

  1. Navigate to Classroom from the teacher or admin dashboard.
  2. Click Create Class.
  3. 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.
  4. 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):

  1. Open the class you want to edit.
  2. Click Add Section.
  3. Enter the section name.
  4. The section is created under the class and can have its own set of students and teachers.

Managing Members​

Adding Individual Members​

  1. Open a class or section.
  2. Click Add Member.
  3. Select the user from your organization's user list.
  4. Set the role -- either student or teacher.
  5. Optionally assign a roll number (for students).
  6. 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​

  1. Find the member in the class roster.
  2. Click Remove.
  3. Confirm the removal. The member is immediately removed from the class.

Bulk Student Import​

For large classes, you can import students from a spreadsheet:

  1. Navigate to Bulk Import (available from the classroom page or admin tools).
  2. Download the template file (Excel or CSV format).
  3. Fill in student details: first name, last name, email, phone, class name, and roll number.
  4. Upload the completed file (supports .xlsx, .xls, and .csv, up to 10 MB).
  5. 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.
  6. Confirm the import. New user accounts are created and students are assigned to the specified class.

Bulk Student Import

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​

RoleCapabilities
TeacherCreate classes, manage members, assign exams to classes, view class analytics
StudentView their enrolled classes, access assigned exams and materials
AdminAll 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.