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

# Timetable

> Set up your teaching week, and place your planned work into it.

The timetable is your teaching week: which periods you teach, which classes fill
them, and what you are covering in each.

## It starts already set up

The first time you open it, MESO seeds a **default Irish post-primary week** —
Monday to Friday, ten periods, with break and lunch as real rows rather than
gaps.

Most teachers adjust that rather than build from nothing.

## The parts

| Part | What it is |
| - | - |
| **Day structure** | The shape of a teaching day — its periods, their times, and which are break or lunch |
| **Periods** | The individual slots, with a label and a start and end time |
| **Classes** | The groups you teach: a class code, subject, year group, room and colour |
| **Placements** | Which class sits in which period, recurring week to week |

Your day structure, classes and recurring placements are the part that **does
not change from week to week**. That is set up once and then largely left alone.

## Placing your work

Planned items can be placed into the week. Four kinds can go in:

* **Lessons** from your units
* **Assessments**
* **Resources**
* **Custom** entries, for anything else

This is how a unit stops being a document and becomes a week — the lesson you
planned lands on the day you are teaching it.

> [!TIP]
>
> Give each class a distinct colour when you set it up. On a full ten-period week
> across five days, colour is what makes the timetable readable at a glance.

## Classes and units

A class can be linked to a unit, which is what connects the group you teach to
the plan you are teaching them. Classes can also be **archived** when they are
no longer running, rather than deleted, so the history stays intact.

## Changing the shape of the day

If your school's day does not match the default — a different number of periods,
different times, a split lunch — edit the day structure rather than working
around it. Everything else hangs off it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.