---
title: Manage program versions
description: >-
  Create study program versions, switch between them in Campus Management, and
  see which cohorts belong to each version without moving existing intakes.
sidebar:
  order: 4
  hidden: true
---

Study program **versions** let you update program rules for new intakes while keeping existing cohorts on the version they started with. Each cohort is created under a specific program version and stays linked to that version.

Versioning is the academic equivalent of "same degree, new regulation year." Accreditation changes, curriculum reforms, and fee or ruleset updates often apply only to students who start after a cutoff. Program versions give that cutoff a first-class home in FuxamCMS without rewriting history for students already enrolled.

For the conceptual deep dive and a multi-year worked example, see [Program versions explained](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/program-versions-explained).

:::tip
Creating a new version does **not** move existing cohorts. Add new cohorts under the new version for students starting under updated rules.
:::

## Why it matters

Without versions, every configuration change risks applying to every cohort under the program. With versions:

- New intakes get updated rules, connected curricula context, and settings.
- Earlier cohorts remain on the snapshot they started under.
- Staff can see which cohorts use which version via the header selector and **Cohorts** tab.
- [Apply](/docs/fuxam-web/apply/getting-started) and [academic rulesets](/docs/fuxam-web/cms/exams-and-reporting/academic-rulesets) can target the correct regulation year.

Create a new version when the *next* intake should differ; keep editing the current version only for administration that should stay on that snapshot.

| Related area | Relationship |
|---|---|
| [Create a study program](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/create-a-study-program) | Every new program starts with an initial version |
| [Program versions explained](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/program-versions-explained) | Why versions exist for accreditation and regulations |
| [Create a cohort](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/create-a-cohort) | Cohorts are always created under the currently selected program version |
| [Edit a study program](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/edit-a-study-program) | Version-specific **Settings** after selecting the version |
| [Curricula](/docs/fuxam-web/cms/academic-structure/curricula) / [Manage curriculum versions](/docs/fuxam-web/cms/academic-structure/curricula/manage-curriculum-versions) | Academic blueprints are versioned separately; assign the right curriculum version to each cohort |
| [Academic rulesets](/docs/fuxam-web/cms/exams-and-reporting/academic-rulesets) | Attach regulation-year exam policy to the program or its cohorts |
| [Fuxam Apply](/docs/fuxam-web/apply/getting-started) | New intakes in admissions should target cohorts under the correct program version |
| [Study programs and cohorts](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts) | Full domain model |

:::note
**Program version** and **curriculum version** are different layers. The program version scopes cohorts and program settings; the curriculum version scopes the module blueprint those cohorts receive. Both may change for a new intake — often together, but managed in different places.
:::

## Before you start

- Decide a clear **Version Name** (for example, "2025 intake" or "Updated curriculum 2025").
- Confirm whether existing cohorts should stay on the current version (almost always yes).
- Prepare any new [curriculum version](/docs/fuxam-web/cms/academic-structure/curricula/manage-curriculum-versions) you will assign to cohorts under the new program version.
- Prepare any new [academic ruleset](/docs/fuxam-web/cms/exams-and-reporting/academic-rulesets) version if exam policy changes with the intake.
- Plan new [cohorts](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/create-a-cohort) for the next intake under the new version after it exists.

## View and switch versions

1. Open a study program from **Campus Management → Programs**.

2. Use the **version selector** in the page header to see all versions for this program.

3. Select a version to open its **Cohorts**, **Users**, **Module Planning**, **Course Planning**, and **Settings** tabs for that version.

The **Cohorts** tab lists only cohorts that belong to the currently selected version. Switch versions to see which cohorts use each one.

## Create a new version

1. Open the study program and click the version selector in the header.

2. Select **Manage versions** to open the **Versions** dialog.

3. Create a new version and enter a **Version Name** (for example, "2025 intake" or "Updated curriculum 2025").

4. Save the new version. It appears in the version selector alongside existing versions.

:::info
Creating a new version does not move existing cohorts. Cohorts remain on the version they were created under. Add new cohorts under the new version for students starting under updated rules.
:::

After creation, select the new version and configure its **Settings** (connected curricula, rulesets, responsible users) before opening admissions for that intake.

## Which cohorts use which version

| To see… | Do this… |
|---|---|
| Cohorts on a specific version | Select that version in the header, then open the **Cohorts** tab |
| Version count from the list view | Check the **Versions** column on the Programs table |
| Settings for a version | Select the version, then open **Settings** |

When requirements change mid-cycle, keep the current cohort on its existing version and create a new version with new cohorts for the next intake.

## When to create a new version

| Situation | Guidance |
|---|---|
| New regulation or curriculum year for the next intake | Create a new program version; create new cohorts under it |
| Accreditation-driven change for *new* starters only | New version + new cohorts; see [Program versions explained](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/program-versions-explained) |
| Typo in program name or ownership change | Edit the current version via [Edit a study program](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/edit-a-study-program) |
| Only one cohort needs a different curriculum | Change that cohort's curriculum — see [Manage cohort curriculum](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/manage-cohort-curriculum) |
| Exam policy changes for one intake | New or reassigned [ruleset](/docs/fuxam-web/cms/exams-and-reporting/academic-rulesets); often paired with a new program version |
| Program is closed entirely | [Archive the study program](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/archive-a-study-program) rather than adding versions |

## Best practices

- Name versions after the intake year or rule set staff will recognize in the selector.
- Always create new cohorts under the version that matches their academic rules — do not "reuse" an old version for a reformed intake.
- Pair program-version changes with the correct [curriculum version](/docs/fuxam-web/cms/academic-structure/curricula) assignment at cohort creation.
- Use the **Versions** column on the Programs table as a quick health check: many versions may be fine, but unexplained growth can mean accidental duplicate versions.
- After creating a version, configure its **Settings** (connected curricula, rulesets, responsible users) before opening admissions for that intake.
- Point Apply forms at cohorts under the **new** version when the admissions cycle matches that regulation year.

## Common pitfalls

| Pitfall | Why it hurts | What to do instead |
|---|---|---|
| Expecting a new version to migrate existing cohorts | Cohorts stay on their original version | Create new cohorts under the new version |
| Creating cohorts under the wrong version | Students follow the wrong Settings and version context | Switch the version selector before opening **Cohorts** → **Cohort** |
| Editing Settings on an old version for a new policy | New policy never reaches the new intake | Select the new version first, then edit Settings |
| Confusing program version with curriculum version | Wrong layer gets updated | Change program version for offering/rules snapshot; change curriculum version for module blueprint |
| Opening Apply against last year's cohort | Applicants land on the wrong regulation snapshot | Link the application program to cohorts under the correct version |

## FAQ

**Does every program have at least one version?**

Yes. Creating a study program also creates an **initial version**. Additional versions are optional and added when requirements diverge for new intakes.

**Can I move a cohort to another program version?**

Cohorts remain on the version they were created under. Plan the correct version at [cohort creation](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/create-a-cohort) time.

**How do I know how many versions a program has?**

Check the **Versions** column on the Programs table, or open the program and use the version selector / **Manage versions** dialog.

**Where is the conceptual guide for accreditation changes?**

See [Program versions explained](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/program-versions-explained).

## Related pages

**[Program versions explained](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/program-versions-explained)**

Why versions exist, with a worked multi-year example.

**[Create a cohort](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/create-a-cohort)**

Add a cohort under the correct program version.

**[Edit a study program](/docs/fuxam-web/cms/programs-and-planning/study-programs-cohorts/edit-a-study-program)**

Edit version-specific settings after selecting the version.

**[Manage curriculum versions](/docs/fuxam-web/cms/academic-structure/curricula/manage-curriculum-versions)**

Version the academic blueprint assigned to cohorts.
