Introduction
Enrollment rules make it possible to automatically enroll users into courses or learning plans upon joining a particular group or branch.
For example, if you configure an enrollment rule for the group “new hires” and the learning plan “onboarding”, any user who is added to the “new hires” group will be automatically enrolled in the “onboarding” learning plan.
→ Note that the enrollment rule is only triggered when users are added to a group or branch. Pre-existing members will not be automatically enrolled. For more information see Notes on automatic enrollments.
When you configure an enrollment rule, you specify:
- The groups or branches that will trigger the enrollment rule when new users are added to them.
- The courses or learning plans into which users will be automatically enrolled when the rule is triggered.
Note that you cannot combine groups and branches within the same rule: You can specify a set of groups or a set of branches, but not a mixture of groups and branches. Similarly, you cannot combine courses and learning plans within the same rule.
The Enrollment rules app can be managed by all Superadmins and by the Power Users with the Enrollment / Manage enrollment rules permission and only for the resources assigned to them.
Requirements and limitations
- Enrollment rules are available for e-learning courses, ILT courses, and learning plans but are not available for the sessions of ILT courses.
- Enrollment rules do not trigger enrollments on deactivated users.
Learn more on DoceboU!
Want to learn more about enrollment rules? Have a look at the dedicated course, How to use enrollment rules (opens in a new tab) on Docebo U!
Use case scenario
To implement a course access hierarchy using enrollment rules and automatic groups, set up groups that move users through content based on specific conditions, like hire date or course completion, enabling sequential learning paths.
- Step one: When new users are created in the platform, they are added to the New hires automatic group based on their hire date user additional field (User additional fields based condition). Then, set an enrollment rule to automatically enroll members of the New hires group in the Onboarding course.
- Step two: Create a Permanent employees automatic group that adds users upon completion of the Onboarding course (Enrollment status based condition). Then, add an enrollment rule so users in this group automatically enroll in a Mandatory learning plan for all employees.
This setup structures content access based on specific learning progression criteria, ensuring that users advance only after meeting defined requirements.
Activating the Enrollment rules app
Activate the Enrollment Rules app as described in the Managing apps & features article of the knowledge base. The app is listed in the Docebo additional features tab.
Creating enrollment rules
To create enrollment rules, once you have activated the Enrollment Rules app, access the Admin menu by clicking on the gear icon in the top right corner of your platform. Find the Enrollment rules section and press the Manage subitem.
You will land on the main page of the Enrollment rules app, listing all of the rules you have already configured in the Rules tab. Add a new rule by clicking on the plus button in the top right corner.
In the right tab that opens, set a code and a name for your rule, then define whether the rule will automatically enroll users belonging to groups or branches in courses or learning plans by selecting the corresponding options. Click on Create and edit to create the rule and to start configuring it.
Assigning and unassigning resources to rules
Once you have created a rule as described in the Creating enrollment rules chapter of this article, you can assign resources (users, courses, learning plans and notifications) to it either from the rule configuration area you access after creating the rule or from the main Enrollment rules page by clicking on the ellipsis menu at the end of the rule row and selecting the Edit option.
Once in the rule configuration area, click on the plus button in the top right corner to assign resources to the rule. As an option, you can quickly assign resources to the rule from the Assigned Resources tab, by clicking on the ellipsis menu at the end of the resource type in the Resources area on the left and selecting Assign.
Independently from where you access the resource assignment functionality, a right panel will open. Depending on the settings you have selected when creating the rule, you will be able to select either groups or branches and either courses or learning plans. When working with branches, you can select sub-branches too, but when you select a sub-branch, its parent branch is not selected by default.
In addition, you can also configure notifications to be sent to the users associated in the rule upon enrollment. Refer to the Enrollment Notifications chapter of this article for more details on notifications.
Select the resource type by checking the checkboxes next to the resource names and click Update. The assigned resources are listed in the Assigned Resources tab, divided by resource type.
In order to unassign a resource (including notifications), click on the ellipsis menu at the end of the resource row and select Unassign.
Notes on automatic enrollments
Enrollment rules are not retroactive
Remember, an enrollment rule is triggered only when users are added to the specified groups or branches.
Therefore, users who already belong to the groups or branches will not be automatically enrolled. The rule will enroll only the users added to a group or a branch after the rule is activated.
In addition, if you add a course or learning plan to an existing enrollment rule:
- Users belonging to the group or branch already assigned to the rule will not be enrolled in the newly added content.
- You have to remove them from the group or branch and add them back again to trigger the rule, and so have them automatically enrolled in the content.
However, if you remove a course or a learning plan from an enrollment rule, the users belonging to the group or the branch assigned to the rule are not unenrolled from the course or learning plan.
Learning plans
The standard behavior for learning plans is that:
- When a course is added to a learning plan, the users enrolled in the learning plan are automatically enrolled in the newly added course.
- But when a course is removed from a learning plan, the learning plan users are not automatically unenrolled from the course.
This behavior also applies to learning plans that are assigned to enrollment rules. If the enrollment rule causes a user to be enrolled in a learning plan, the user will be auto-enrolled in all its courses, and also into any courses later added to the learning plan. And these enrollments will not be lost if the learning plan is removed from the rule, or if courses are removed from the learning plan.
Automatic groups
If you assign an automatic group to an enrollment rule, remember that the population of these groups is processed asynchronously and may fluctuate due to platform events. This may result in the rule being triggered unexpectedly, as pre-existing members of the group are briefly removed and then added back.
For example if you add a course to an active enrollment rule configured for a group, you would expect existing group members to not be enrolled in that course. However, if some platform event causes the automatic group membership to be recalculated, any members removed and added back will be enrolled.
Configuring the enrollment validity period
Activate the Enable deadline option to set a content access period for learners enrolled in courses or learning plans linked to the rule, defining the validity period of their enrollments. Alternatively, you can set only the start date for enrollment validity, without specifying a deadline. The validity period you configure will be the same for all the learners enrolled in the content by the enrollment rule. You can then configure personalized validity periods at the learner level by editing single enrollments.
This configuration sets the validity of the enrollments from the moment learners are enrolled in courses or learning plans via the enrollment rule. When this option is enabled, set the enrollment validity period by using the following options:
- Start date. Set the first available date for learners to access the course or learning plan. The content will have no deadline and will not be displayed in the My calendar widget and page. The start date is expressed in UTC, meaning that the content will be accessible at 00:00:00 UTC on the selected date. If, for example, your timezone is UTC +04:00, the content will be accessible at 04:00:00 on the selected date.
- End date. Set the last available date for learners to access and play the course or learning plan. After this date, the content will no longer be accessible. The end date is expressed in UTC, meaning that the content will be locked at 23:59:59 UTC of the selected date. If, for example, your timezone is UTC +04:00, the course will be locked at 03:59:59 of the following day.
- Timezone: Select the timezone for the calculation of the validity period.
Setting the enrollment priority
Once you have assigned courses or learning plans to an enrollment rule, if the Show the Enrollment attributes option is enabled in the platform's advanced settings, the rule General tab shows the Enrollment attributes section which allows you to set the enrollment priority which informs learners if the courses and learning plans in which they are enrolled via the enrollment rule are mandatory, required, recommended, or optional.
Setting an enrollment priority helps learners understand which courses and learning plans they must complete first and which ones are less critical or entirely optional.
When set, the enrollment priority is displayed on courses and learning plans cards on the My courses and learning plans page and learners can filter content according to its priority.
Enrollment notifications (Updated!)
If the notifications feature is active on your platform, you can opt to notify users of the enrollments that occur as a result of a rule. You do this by associating a notification of type Digest: User enrolled in a course. Notifications are associated at rule level, so you can consider whether to activate them only for some rules.
Select Admin menu > Enrollment rules and click the <enrollment rule name> to open its configuration page. There, in the Assigned resources tab, select Notifications to see the notifications currently associated with the rule, if any.
To associate a notification, click the Assign resources (+) button in the top right corner, select Notifications and click Next. The Eligible notifications list will show all the active notifications of type Digest: User enrolled in a course that are configured in the platform:
- Select the check box next to the notification that you want to send.
- Make sure the chosen notification has the appropriate recipient audience.
- If the notification has trigger filters, make sure these include the groups or branches and the courses or learning plans configured in the enrollment rule. Otherwise the notification will not fire in the case of resources that are filtered out.
When you are finished click Assign.
The notification you select will be immediately sent out when an enrollment occurs as a result of this rule.
Disclaimer: This chapter describes the configuration of enrollment notifications with the new notification service. For platforms using legacy notifications, the procedure is slightly different. The following steps must be performed in order:
- First of all, in Admin menu > Advanced settings > Advanced options you must flag the option Send immediate notification digest on massive enrollment action.
- Next, set up the Digest: User Enrolled in a Course notification, making sure that the groups and branches set for the notification match those of the enrollment rule.
- Finally, you can associate the notification to the enrollment rule.
By contrast, in the New notification service the advanced setting is no longer required and any notification of type Digest: User enrolled in a course can be assigned, irrespective of its scheduling.
Activating and deactivating enrollment rules
Enrollment rules are created as inactive rules so that you can enable them once you have completed their configuration.
In order to activate them, move to the main Enrollment Rules page and click on the circle in the Status column corresponding to the rule you wish to activate, turning it into a checkmark.
You can deactivate rules at any time by pressing the checkmark, and turning it back to an empty circle.
Managing enrollment rules
All of the rules created in your platform are listed on the main Enrollment Rules page.
From here you can:
- click on the rule name to access its configuration area
- click on the icon representing groups/branches, courses/learning plans, and notifications in the rule row to directly access the Assigned Resources tab already filtered for that resource
- activate and deactivate the rule using the Status column
- edit the rule by clicking on the ellipsis menu at the end of the rule’s row and selecting the Edit option
- delete the rule by clicking on the ellipsis menu at the end of the rule’s row and selecting the Delete option. When a rule is deleted, the users already enrolled in courses and learning plans by the rule will keep their enrollment status
Enrollment rules logs
You can see all users that have been assigned to specific courses or learning plans from your enrollment rules from the Logs tab in the main Enrollment Rules page.
Each row shows the date and the time when the enrollment occurred, the username of the enrolled user, the rule type and name and the number of courses and learning plans the user has been enrolled in.
Click on the icon in the Courses / learning plans column to see a recap of the courses and learning plans where the user has been enrolled.
Rolling back automatic enrollments
You can roll back the enrollments automatically done by enrollment rules from the Logs tab in the main Enrollment Rules page. This operation can be done both for a single user or for a selection of users, unenrolling them from ALL of the courses and learning plans they have been automatically enrolled in.
Once in the Logs tab, identify the user you would like to unenroll, click on the ellipsis menu at the end of the user row and select the Roll Back option. The user will be unenrolled from all of the courses and learning plans he or she has been enrolled in through automatic enrollment rules.
You can roll back the enrollments for a selection of users by clicking on the checkboxes at the beginning of their corresponding row, then selecting the Choose Action button in the bottom right corner of the table, and finally Roll Back. Set now whether to unenroll users from learning plans only, or also from the courses included in learning plans.
Rollbacks are managed with background jobs.