Bulk Class Creation
When setting up a new academic year or branch, you may need to create dozens of classes at once. The bulk creation feature lets you upload a CSV file to create multiple classes in a single operation, saving significant time over individual creation.
Step-by-Step Guide
1
Navigate to Bulk Create
Go to Classes → Bulk Create. This opens the bulk class creation page with a CSV upload interface.
2
Download the Template
Click "Download Template" to get a pre-formatted CSV file with the correct column headers. Fill in your class data using this template.
3
Prepare Your CSV File
Open the template in a spreadsheet application (Excel, Google Sheets) and fill in one row per class. Ensure required fields (name, code, grade, academicYear) are filled for every row.
4
Upload the CSV
Click "Upload CSV" or drag and drop your file onto the upload area. The system parses the file and shows a preview of the classes to be created.
5
Review & Fix Errors
The preview highlights any validation errors in red — missing required fields, duplicate codes, or invalid values. Fix errors in your CSV and re-upload, or correct them inline.
6
Confirm Creation
Once all rows pass validation, click "Create Classes" to bulk-create them. A progress indicator shows how many classes were created successfully.
CSV Template Format
The CSV file must include headers in the first row. Column names are case-sensitive and must match exactly. Here are the supported columns:
| Field | Required | Type | Description |
|---|---|---|---|
name | Required | text | Class display name. Min 3 characters. Example: "Grade 10 - Section A". |
code | Required | text | Unique class code within the organization. Example: "G10-A". Used for identification. |
grade | Required | text | Grade or level identifier. Example: "10", "KG", "JEE". |
section | Optional | text | Section identifier. Example: "A", "B". Leave empty for single-section grades. |
academicYear | Required | text | Academic session. Format: "2024-2025". |
maxStudents | Optional | number | Maximum student capacity. Defaults to a reasonable value if not specified. |
description | Optional | text | Optional notes about the class. |
term | Optional | text | Term or semester. Example: "Term 1", "Semester 2". |
classType | Optional | text | One of: standard, batch, course, program, department, custom. Defaults to "standard". |
Example CSV
Here is a sample CSV for creating classes for a school with grades 6 through 8, each with two sections:
| name | code | grade | section | academicYear | maxStudents |
|---|---|---|---|---|---|
| Grade 6 - A | G6-A | 6 | A | 2024-2025 | 40 |
| Grade 6 - B | G6-B | 6 | B | 2024-2025 | 40 |
| Grade 7 - A | G7-A | 7 | A | 2024-2025 | 35 |
| Grade 7 - B | G7-B | 7 | B | 2024-2025 | 35 |
| Grade 8 - A | G8-A | 8 | A | 2024-2025 | 45 |
| Grade 8 - B | G8-B | 8 | B | 2024-2025 | 45 |
Validation Rules
The system validates each row before creating classes:
- Required fields:
name,code,grade, andacademicYearmust be present in every row - Unique codes: Each
codemust be unique within the organization. Duplicates are rejected. - Valid class type: If
classTypeis specified, it must be one of: standard, batch, course, program, department, custom - Academic year format: Must match the "YYYY-YYYY" pattern