How to use School Timetable Builder
- Enter Lessons as JSON with subject, teacher, room, group and count for each row. Count creates that many lesson instances. Use exactly the same spelling and letter case for a shared teacher, room or class group.
- List 1 to 7 teaching-day labels separated by commas and choose 1 to 12 periods per day. These are labels and period numbers, not actual clock times.
- To fix one lesson, add both day and period to its row and set count to 1, for example {"subject":"Math","teacher":"Lee","room":"A1","group":"Class 1","count":1,"day":"Mon","period":1}.
- Add unavailable entries such as {"teacher":"Lee","day":"Mon","period":1}. Each entry names exactly one teacher, room or group and a valid teaching-day/period pair.
- The timetable updates as you finish editing. Read its status: Complete means every lesson was placed. Search limit reached leaves feasibility unknown; No complete schedule means the full search ruled out an assignment under these inputs.
- Download school-timetable.json as a record. An incomplete export may include a partial diagnostic assignment; resolve the constraints before treating it as a usable timetable.
Example: School Timetable Builder
Place two Math lessons and two English lessons for Class 1 across five six-period teaching days. Both subjects share A1, so their four instances must use separate class/room slots.
Supported inputs and limits
- 1 to 7 distinct teaching-day labels, at most 15 characters each and 100 characters for the whole day field;
- 1 to 12 periods per day.
- Use 1 to 80 lesson rows with 1 to 20 instances per row and at most 120 instances overall.
- Subject, teacher, room and group each allow 60 characters.
- Lesson JSON is capped at 30,000 characters and unavailable JSON at 20,000, with at most 300 unavailable entries.
More details
A fixed lesson needs day and period together and count 1.
Resource names and day references are case-sensitive.
Search stops at 50,000 steps; reaching that limit does not prove impossibility.
Partial assignments are diagnostic and not guaranteed to be a maximum-size subset.
The tool does not infer lunch, travel time, preferences, shared-resource aliases, weekly lesson spacing or clock durations.
The JSON export is a result record, not a file-import project.
Where your input is processed
This tool does not upload your inputs. See the limits for anything saved on your device.
Questions about School Timetable Builder
Can one teacher teach two classes in the same period?
The scheduler prevents two assigned lessons sharing the same teacher and slot. The same rule applies to rooms and class groups.
Does an incomplete result prove the plan is impossible?
A Search limit reached result leaves feasibility unknown. No complete schedule satisfies these constraints means the search finished without a full assignment. Neither status makes a partial diagnostic plan ready to use.
How are weekly subject hours represented?
Set count on each subject lesson row. The planner expands that row into the requested number of lesson instances.