> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizaxl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Classrooms and Roster

> Create a classroom, link it to your LMS programme and batch, set the teaching team and grade scheme, enrol students, and structure the class into sections and activities.

A Classroom is the central record in E-Classroom. It ties together the LMS content you are teaching, the students you are teaching it to, and the way their work will be graded. Everything else - sessions, attendance, assignments, quizzes, grades - hangs off a classroom.

***

## Who Uses This Feature

| Role                        | What They Do                                                                                   |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| **Classroom Administrator** | Creates classrooms, links LMS records, assigns the teaching team, and manages every classroom. |
| **Teacher**                 | Manages the roster, sections, and activities for their own classrooms.                         |
| **Student**                 | Opens their classroom to see its sections, activities, and resources.                          |

***

## Before You Start

You need, in the LMS:

* An **LMS Programme** the class belongs to
* One or more **LMS Courses** (and their chapters) to teach
* An **LMS Batch** the students are enrolled in
* A **grade scheme** chosen or created (see [Grading](/education/e-classroom/grading))

A classroom links to these records; it does not replace them.

***

## Creating a Classroom

<Steps>
  <Step title="Open a new Classroom">
    From the administrator views, open the Classroom list and start a new record.
  </Step>

  <Step title="Give it a code and link the LMS records">
    Enter the classroom code (this becomes the class's address in the portal) and link the programme, courses, chapters, and batch.
  </Step>

  <Step title="Name the teaching team">
    Set the main teacher and add any co-teachers.
  </Step>

  <Step title="Choose a grade scheme">
    Select the weighted scheme that decides how attendance, assignments, and quizzes combine into a grade.
  </Step>

  <Step title="Activate">
    Move the classroom from Draft to Active so it appears for its roster.
  </Step>
</Steps>

### Field Guide - Classroom

| Field              | Description / Purpose                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------- |
| **Classroom Code** | The unique identifier and the class's address in the portal (`/classroom/{code}`). Required. |
| **Programme**      | The LMS programme this class belongs to.                                                     |
| **Courses**        | The LMS courses being taught in this class.                                                  |
| **Chapters**       | Specific course chapters pulled into the class.                                              |
| **Batch**          | The LMS batch whose enrolment feeds the roster.                                              |
| **Teaching team**  | The main teacher and co-teachers.                                                            |
| **Grade Scheme**   | The weighted scheme used to compute grades.                                                  |
| **Roster**         | The students enrolled in the class.                                                          |
| **Status**         | The lifecycle state: Draft, Active, or Archived.                                             |

***

## The Classroom Lifecycle

A classroom moves through three states:

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#14f1b1','primaryBorderColor':'#14f1b1','lineColor':'#14f1b1'}}}%%
flowchart LR
    D[Draft] --> A[Active] --> R[Archived]
```

* **Draft**: the class is being set up and is not yet visible to students.
* **Active**: teaching is under way; the class appears for its roster.
* **Archived**: the term is over; the class becomes read-only but its records and grades remain.

***

## Managing the Roster

The roster is the list of students in the class. You can enrol students one by one, or backfill the whole roster from the linked LMS batch so you do not re-enter people who are already in the batch.

<Steps>
  <Step title="Open the Roster page">
    Go to `/classroom/{code}/roster`.
  </Step>

  <Step title="Add students">
    Search for a student and add them, optionally recording an admission number.
  </Step>

  <Step title="Suspend or remove when needed">
    Suspend a student for a period (or indefinitely) with a reason, lift the suspension later, or remove them from the roster entirely.
  </Step>
</Steps>

### Field Guide - Roster entry

| Field                 | Description / Purpose                                        |
| --------------------- | ------------------------------------------------------------ |
| **Student**           | The person enrolled in the class. Required.                  |
| **Admission number**  | An optional reference recorded against the enrolment.        |
| **Suspended until**   | If suspended, the date the suspension lifts (or indefinite). |
| **Suspension reason** | Why the student is suspended.                                |

<Info>
  Suspending a student keeps their record and history but pauses their access. Removing a student takes them off the roster. Prefer suspension when the change may be temporary.
</Info>

***

## Structuring the Class: Sections and Activities

A classroom is organised into **sections** (ordered units) that contain **activities**. An activity is a single piece of work: a lesson, a quiz, or an assignment, each of a given activity type.

<Steps>
  <Step title="Add sections">
    Create sections and order them to shape the flow of the class. You can rename and reorder them at any time.
  </Step>

  <Step title="Add activities">
    Place activities inside a section. You can bootstrap activities directly from the linked course chapters so you do not rebuild content that already exists in the LMS.
  </Step>

  <Step title="Reorder as the class evolves">
    Drag sections and activities into the order you want students to work through them.
  </Step>
</Steps>

***

## Upstream and Downstream

* **Upstream (must exist first)**: LMS programme, courses, chapters, and batch; a grade scheme.
* **Downstream (this enables)**: sessions and attendance, assignments, quizzes, grading, and recordings all attach to the classroom once it is Active.

***

## Best Practices

* Set the grade scheme before the class goes Active, so early grades are weighted correctly from the start.
* Backfill the roster from the batch rather than adding students by hand when the batch enrolment already exists.
* Bootstrap activities from course chapters to keep the class aligned with the LMS content.
* Archive a class at the end of term rather than deleting it: archiving preserves grades, attendance, and recordings for reference.