Enable Course Versioning
Table of Contents
Overview
Course Versioning requires all active Courses to lookup to a Course Header. To help transition to this new data model, we have introduced an automatic data update if you enable the Course Versioning feature through the RIO Education - App Settings.
Warning!
It is HIGHLY RECOMMENDED to enable the feature this way, and to confirm the upgrade job completed with no errors. If Courses are not setup correctly, this could cause data issues down the line.
Important — this only prepares the data, not the UI:
Enabling Course Versioning runs a backend data update that creates Course Headers and populates the Version field on existing Course records. This process does not automatically expose the Version field (or any other versioning-related fields) anywhere in the user interface.
After enabling the feature, an admin still needs to perform their own analysis and decide where — if anywhere — versioning information should be surfaced, for example:
- Page Layouts — adding the Version field (and related fields, like Course Header) to the Course page layout(s)
- Lightning Record Pages — adding the field(s) to any Lightning App Builder pages/components
- Flows/Wizards — updating any Screen Flows or setup wizards that create or edit Courses, so users are prompted for or shown versioning data where appropriate
Until this configuration is done, the data will be correct behind the scenes, but users won't see or interact with it through the standard UI.
The same applies when disabling the feature. Disabling Course Versioning reverses the logic, but any data, fields, layouts, or flow steps you added to expose versioning will need to be reviewed and removed/reverted separately — disabling the feature does not automatically undo the data and UI changes you made.
Upgrade Job Details
When enabling the Course Versioning feature using the RIO Education - App Settings, a new Job Queue Group will be queued to update your existing Course records. The following changes will be made:
- A Course Header will be created for each Course where:
- Course Header = null
- Status = null OR Status = Active
- (Status will be null for existing Courses before upgrading to v3.24)
- New Course Header details:
- Name = [Course Name]
- Course ID = [Course ID]
- Educational Institution = [Course's Department's Educational Institution]
- Courses will be updated:
- Course Header = [New Course Header]
- Latest = true
- Status = Active
- Version = 1, unless already specified differently on the Course
How to Enable
1. Go to the App Launcher, and find the RIO Education - App Settings

2. Go to the Feature Settings tab

3. Click the Enable button to enable the Course Versioning feature.
4. After confirming to run the data update job, you should see the status of the job underneath the setting. (If it says Draft, it is still processing. Refresh the page to monitor the status).

5. If the job has failed with any errors, you can view the Job Queue Group record for more details, by searching for Course_Version_Course_Update_SYSTEM
