Completion Logic
There are five content types in Litmos: Assets, Modules, Courses, Learning paths, and Collections. Out of these five types, Completion only applies to Courses and Learning paths.
- Only Courses can be marked as ‘Complete’ for a user.
- All Modules in a course should/will be completed when a course status is set to ‘Complete.’
- Similarly, all required modules within the courses must be completed fully to update the course completion percentage.
- Partial completion of the module does not impact the course completion percentage.
- Learning path completion is a roll-up of the course completion. Learning Path completion cannot be updated directly.
- All required courses must be completed in full for the Learning Path completion to get updated.
- Partial completion of the courses does not impact the Learning Path completion percentage.
- Modules can be completed only in the context of Courses. There is no stand-alone module completion.
- Assets and Collections do not have a completion associated with them.
How the Completion Percentage is Calculated for Courses and Learning Paths
Let us look at some examples to understand how the calculation works:
- If a course has four modules and a user has completed two of the four modules, the user’s completion will be at 50%.
- If a Learning Path has five courses and a user has completed two of the five courses, the user’s completion will be at 40%.
- If a course has two modules and a user has partially completed one of the two modules, the user’s completion will be 0%.
- If a user is assigned to a course X containing two modules, one of them is a linked module, then completing the linked module via the other course will update the user’s completion of Course X to 50%.
- If a user is assigned to a Learning Path X containing two courses, A and B, and they complete course A, their completion of Learning Path X will be updated to 50%.
Recalculation Logic
Changes Made to Content After User Assignment/Enrollment
When updating active and assigned Content (Module, Course, or Learning Path) with assigned or enrolled users, be aware of the impact of these changes.
Default Recalculation Behavior
Here is the summary of the recalculation behavior. Below, you will find a detailed description of all aspects of such changes. Please use the links to navigate to the corresponding section.
- All changes noted below apply retroactively. Changes will be visible to all enrolled users, regardless of their status in training.
- Updates may trigger auto–recalculation of the completion percentage for In-progress and Incomplete users.
- Updates DO NOT trigger auto-recalculation of the completion percentage for Completed users. These users will not be required to retake the training based on the changes alone. (Exceptions, as noted in the below section, apply)
- An alert message will appear within the content tab of courses and learning paths to alert Admins of the actions which may invoke auto-recalculation of completion progress.
How the Completion Percentage is Recalculated for Courses and Learning Paths
- Suppose a user is 100% complete on a course, and the Admin removes a module from the course by default. In that case, there is no impact on the user’s completion percentage.
- If a user is 100% complete on a Learning Path, and the Admin adds a course to the Learning Path. In this case, there is no impact on the Completion percentage by default.
- Suppose a user is 33% complete on a three-module course, and Admin adds a new module. In that case, the user’s Completion percentage will be updated to 25%.
- Suppose a user is 50 % complete on a four-module course, and the Admin removes an incomplete module. In that case, the Completion percentage will be updated to 67% for the user.
- Suppose a user is 50% complete on a four-module course, and the Admin removes two of the completed modules. In that case, the user’s Completion percentage will be updated to 0%.
- If a user is 100% complete on a two-course Learning Path, and the Admin adds a new course, there will be no impact on the completion percentage of the learning path. But suppose the user self-assigns a course and starts this newly added course from the content library. In that case, the user’s learning path completion will be recalculated and updated to 67%.
Opt-in Recalculation Behavior (Default Behavior Override Condition)
Admins can override the default recalculation behavior for completed users done automatically upon updating content. They can enable this opt-in feature for the Courses and Learning path in the Account profile > Courses/ Learning path section.
When Admins enable this setting, the individual courses and Learning path will show the following message in the Learning path > Content and Courses > Content tabs: “Adding or removing modules or changing status (active/inactive or optional/mandatory) will update results for all assigned users that are already complete and not complete.”
Note: If the auto-recalculate feature is enabled only for the Learning path and updates are made to modules in a Learning Path > Course, the Learning Path will not be recalculated.
Impact of Module Updates on User Completions
The module setting updates impact the following modules:
- POI Module settings
- Assessment Settings
- Multiple choice
- Keyword
- Free text
- Info Page
- Hotspot
- Match
- Sequence
- Survey
- ILT/vILT
- Checklist
- Learner Upload
- Embed content
- Link module
- Video Assessment
- E-signature
- SCORM
- Uploaded files
The auto-recalculation behavior stated below is true regardless of whether the ‘Auto-recalculate for the completed user on Courses and Learning Path’ flag is enabled or disabled at the Org level.
Changes to Module settings are retroactive
- If the Admin updates the module settings post-enrollment, the update will be visible to all enrolled users regardless of their completion status.
Impact of Module Changes on In–complete/ In-Progress Users
- Module setting updates, such as updating fields, existing files with a new file, or changing ILT session details, do not trigger the recalculation of courses or Learning path for any enrolled user, regardless of their completion status.
Impact of Module Changes on Completed Users
- The module setting updates do not trigger the recalculation of courses or Learning path for any enrolled user, regardless of their completion status.
Impact of Course Updates on User Completions
Course Setting Changes | Condition | Are Changes Retroactive? | Is Incomplete/In-Progress User Auto-Recalculated? | Is Complete User Auto-Recalculated? |
---|---|---|---|---|
Course access expiration updated | The ‘Update this date for all people already assigned to the course’ flag is enabled at the course level. | Yes, conditionally
The updated expiration will only apply to all enrolled users if the condition is true. |
Yes, conditionally
The updated expiration will only apply to all enrolled users if the condition is enabled. |
Yes, conditionally
The updated expiration will only apply to all enrolled users if the condition is enabled. |
Active to Inactive (and vice versa) | The ‘Auto-recalculate for completed user’ flag is enabled at each Org level. | Yes. If an inactive Learning Path is marked active, the newly active Learning Path is available to all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes. Conditionally This update triggers auto-recalculation for the completed user only if the condition is true. |
All other course settings | Yes. If the Admin adjusts the settings, the updates will be displayed to all enrolled users. |
No. This update doesn’t trigger recalculation for any in-progress and Incomplete users. |
No. This update doesn’t trigger recalculation for completed users. |
|
Add a new Module to the course. | The ‘Auto-recalculate for completed user’ flag is enabled at the Org level. | Yes. If a new module is added to the course, it will be available to all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes. Conditionally. This update triggers auto-recalculation for the completed user only if the condition is true |
Remove an existing Module from a course. | The ‘Auto-recalculate for completed user’ flag is enabled at the Org level. | Yes. If an existing module is removed from a course, the module will be removed for all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes. Conditionally. This update triggers auto-recalculation for the completed user only if the condition is true |
Module flipped from Mandatory to Optional (and vice versa) | The ‘Auto-recalculate for completed user’ flag is enabled at the Org level. | Yes. If an optional module within the course is marked as mandatory, it will be available to all enrolled users |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes. Conditionally. This update triggers auto-recalculation for the completed user only if the condition is true. |
Impact of Learning Path Updates on User Completions
Learning Path Setting Changes | Condition | Are Changes Retroactive? | Is Incomplete User Auto-Recalculated? | Is Completed User Auto-Recalculated? |
---|---|---|---|---|
All other Learning Path settings | Yes. If the Admin adjusts the settings, the updates will display to all enrolled Learners. |
No. This update doesn’t trigger recalculation for in-progress/non-started users. |
No. This update doesn’t trigger recalculation for completed users. |
|
Learning Path Access Expiration | The ‘Update this date for all people already assigned to the course’ flag is enabled at each Learning path level | Yes, conditionally. The updated expiration will apply to all enrolled Learners only if the condition is true |
Yes, conditionally. | Yes, conditionally. |
Active to Inactive (and vice versa) | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If an inactive Learning Path is marked active, the newly active Learning Path is available to all enrolled users. |
Yes, This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. |
Add a new Course to the Learning Path. | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If a new Course is added to a Learning Path, it will be available to all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true |
Remove an existing Course from a Learning Path. | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If an existing Course is removed from a Learning Path, it will be removed for all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true |
Add a new module to a Course within the Learning Path. | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If a new module is added to a course that is within a Learning Path, it will be available to enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true. |
Remove an existing module from a Course that is within the Learning Path. | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If an existing module is removed from a Course that is within a Learning Path, it will be removed for all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true. |
Course flipped from Mandatory to Optional (and vice versa). | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If an optional course within the Learning path is marked as mandatory, the newly mandatory Course will be available to all enrolled users |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true. |
A module within a course is flipped from Mandatory to Optional (and vice versa). | The ‘Auto-recalculate for the completed user’ flag is enabled at the Org level. | Yes. If an optional course within the Learning path is marked as mandatory, the newly mandatory Course will be available to all enrolled users. |
Yes. This update triggers auto-recalculation for in-progress and Incomplete users irrespective of the flag condition. |
Yes, conditionally. This update triggers auto-recalculation for the completed user only if the condition is true. |
Exceptions to the Defined Recalculation Behavior
All In-progress, Incomplete, and Completed users are recalculated when the below conditions occur. The exceptions apply regardless of the condition – The ‘Auto-recalculate for the completed user on Courses and Learning Path’ flag is enabled or disabled at the Org level.
- When a learner voluntarily retakes a previously completed Learning path or a modified course post-completion.
- When an Admin voluntarily resets the user’s results (i.e., Course results), partially or totally, on a Learning path or a modified course post-completion.
- When a Learner self-enrolls and restarts a previously completed course(s) that was modified later from the Content Library.
- When a learner self-enrolls and starts a course(s) that is part of a previously completed Learning Path and was modified later from the Content Library.
- When a learner self-enrolls and restarts a previously completed course(s) modified later, made available in a Collection.
- When a learner self-enrolls and restarts a previously completed learning path(s) that was modified later, made available in a Collection.
- When an Admin sets the course compliance conditions and the course resets for compliance.
- When users are reassigned to the course or learning path via a team.
Note: The above behavior does not apply to incomplete users when an Admin sets the course compliance conditions, and the course resets for compliance.
Achievements of the prior completions will be retained even if the content is recalculated.