Lesson versioning

When you update a lesson and republish it to the Academy, you can now choose how learners experience the update. This allows you to make both small fixes and major revisions without disrupting learner progress unnecessarily.

Tip: Before making edits, check what counts as a structural change (listed below). If your update alters the lesson’s structure, the Update current version option will be unavailable once you try to publish.

Publishing updated lesson versions

After making changes to a published lesson and selecting Publish updates, you’ll be asked to choose one of two publishing options:

1. Update current version

Best for:

• Minor text edits

• Image updates

• Fixing grammar or typos

• Replacing media without changing page structure

What learners see:

• Learners progressing through the current version will see the updates once they launch or resume the lesson.

• Their existing progress is preserved.

• Learners who haven’t started will launch the updated version.

• Completed learners are unaffected.

• Learners progressing through older versions will not see the changes until they launch the latest version.

Available only when the update is structurally compatible.
If the update changes the lesson structure, this option will be disabled.

2. Publish as new version

Best for:

• Adding new pages or blocks

• Rearranging content

• Adding new quiz questions or assessments

• Changing branching or lesson logic

• Structural, interactive, or settings-based updates

What learners see:

• Learners in progress stay on their existing version until they finish.

• Once completed, they will see an Updated label and can choose to start the new version (from the beginning).

• Learners who haven’t started will launch the latest version.

What counts as a structural change?

A structural compatibility check runs automatically.
If any of the following changes are detected, progress cannot be preserved:

• Adding new blocks

• Reordering blocks

• Adding new components inside a block (e.g., new multiple-choice option, new hotspot, new carousel slide)

• Adding a new assessment section

• Adding new questions or question pools

• Changing correct/incorrect answers

• Adding or modifying branching

• Changing theme settings

• Changing completion, progress, or progress-lock settings

If structural changes are detected, Update current version will be disabled.

Accessing the lesson version

1. Go to the storyboard of the lesson you wish to update
2. Make your updates to the lesson
3. Choose the 'Publish updates' option
4. You can now see the new version number and publish by selecting 'Publish updates' 
5. Lesson reports will show which version each learner is on, with filters for better tracking