Browse help docs
Planning a curriculum map
A curriculum map is the programme your school actually teaches, held as records rather than documents. This is how one gets built, activated, and revised without losing what came before.
For Curriculum coordinators, heads of department and teachers · reviewed 23 August 2026
The 2 points where someone must decide
Everything else can be worked on in any order. These cannot move without a person.
- ActivationPlanned → Active
- Second activationPlanned (v2) → Active (v1 archived)
Load the standards you plan against
/teacher/curriculum-library


Mrs. Johnson
Teacher
Curriculum library
Framework elements and your school's own standards
MYP.SCI.A.1
Explain scientific knowledge
MYP.SCI.B.2
Design a scientific investigation
SCH.LIT.3
Our own reading fluency standard
Versions are kept, so a map written against v2020 still reads correctly after a reissue.
A map is only as useful as the things it can point at. Load the framework your school works to — IB objectives, Cambridge learning objectives, CBSE learning outcomes — plus any standards, objectives or policies your school adds on top.
Each standard carries a code, a title and a version. The version matters: when a board reissues a framework, the old codes stay readable rather than being overwritten, so a map written against the previous version still makes sense.
Create the map
/teacher/curriculum-maps


Mrs. Johnson
Teacher
Curriculum maps
Scoped to one programme, grade and subject
MYP · Year 7 · Sciences
v1 · created today
MYP · Year 7 · Individuals & Societies
v1
MYP · Year 6 · Sciences
v2
A planned map affects nothing yet — safe to build over several weeks.
A map is scoped to a programme, a grade and, optionally, a subject — so Year 7 Sciences and Year 7 Individuals & Societies are separate maps rather than one document with headings.
It starts as planned. Nothing that reads curriculum data will use it yet, which is what makes it safe to build a whole year's map over several weeks without half of it going live.
Build the units, then the lessons inside them
/teacher/curriculum-maps


Mrs. Johnson
Teacher
MYP · Year 7 · Sciences
Units in order, lessons inside each
1 · Water systems
4 lessonsConceptual focus · balance within systems
1.1 The water cycle · objectives set
1.2 Catchments and run-off · objectives set
2 · Forces and motion
No lessons yetConceptual focus · cause and consequence
Units are ordered, so the sequence you intend is the sequence the map states. Each carries a title, a summary and its conceptual focus — the idea the unit rests on rather than the topic it covers.
Lessons sit under their unit, also ordered, each with its own objectives. This is the level where a map stops being a plan and starts being something a teacher can pick up.
- Order is explicit, not implied by when something was typed.
- A unit with no lessons is fine while you are drafting — the map simply says so rather than pretending to be complete.
Connect map units to what teachers actually teach
/teacher/curriculum-maps · /teacher/myp · /teacher/pyp


Mrs. Johnson
Teacher
Link to a programme unit
The map becomes a view onto real units, not a parallel document
1 · Water systems
Linked to MYP unit “Water systems” · Y7 Sciences
2 · Forces and motion
No programme unit yet
Units on the map
6
Linked to a real unit
1
taught somewhere
A unit on the map can be linked to the real programme unit that delivers it — a PYP unit of inquiry, an MYP unit. Once linked, the map stops being a parallel document and becomes a view onto the units teachers are working in.
This is what lets a coordinator answer "is this actually being taught" without asking anybody.
Activate it
/teacher/curriculum-maps


Mrs. Johnson
Teacher
Activate this map
Only one version of a map is live at a time
Activating v2 will, in one step:
set v2 to active, and archive v1 — which stays readable as what was taught last year.
v2 · MYP Year 7 Sciences
6 units · 21 lessons
v1 · MYP Year 7 Sciences
Live since Aug 2025
Activating is the moment the map becomes the school's answer to what is taught in that grade and subject. Only one version of a map can be active at a time.
Gate · Activation
Planned → Active
Activating a map archives the previously active version of the same map in the same transaction, so there is never a moment where two versions are both live or neither is. The archived version stays readable — it is what was taught last year.
Revise it as a new version
/teacher/curriculum-maps


Mrs. Johnson
Teacher
Version history
One framework changing over time, not unrelated documents
v3
Created from v2 · units and lessons copied forward
v2
Live since Aug 2026
v1
Taught Aug 2025 – Jul 2026
Editing v3 changes nothing for teachers until it is activated in turn.
Changing an active map in place would rewrite what was taught. Instead, create a new version: it copies every unit and lesson forward, numbers itself in sequence, and starts as planned so you can edit it while the current version stays live.
All versions of a map share one lineage, so the history reads as one framework changing over time rather than as unrelated documents.
Gate · Second activation
Planned (v2) → Active (v1 archived)
A new version is not live until it is activated in turn. Until then teachers keep seeing the version they have been teaching, which is why a mid-year revision does not disrupt anybody.
Who can approve what
Designations are assigned in IB roles and are separate from the account role somebody signs in with.
| Designation | Sees | Approves |
|---|---|---|
| Coordinator | Every map in the school | Activating and archiving versions |
| Teacher | Every map in the school | The same as a coordinator — activation is not restricted, so agree who does it |
| Leadership | Every map in the school | Nothing — this designation is view-only |
If something looks empty
A map you built is not showing up for teachers
It is probably still planned. A map has no effect anywhere until it is activated.
Two versions look active
They cannot be. Activation archives the previous version in the same transaction — check you are not looking at two different maps for the same grade and subject, which is a different thing.
Edits to last year's map changed this year's
You edited the active version rather than creating a new one. Revise by creating a version, which copies everything forward and leaves the live map untouched.
The map has units but coverage still reads nothing
Coverage is counted from approved unit mappings, not from the map itself. See the IB Engine doc — that is a separate step with its own approval.
Still stuck?
Bring the unit you are working on. Thirty minutes with someone who has taught the programme.