In your platform, users can be categorized based on groups, or by branches of the organization chart. Groups are useful whenever there is a set of users with characteristics that are different than those determining the branches of the organization chart. You can create groups manually, or using automatic rules.
Important Notes Before You Start
- If you are using a custom domain, make sure that your custom domain is fully secured using HTTPS.
- The process for adding or changing group memberships works off of platform events. This process constantly analyzes the platform events in order to understand if there are users needing to be added or removed to/from groups, based on these events. As a result, any user modification that involves group modifications is processed asynchronously and the update may be delayed up to one hour.
Use Case Scenarios
If your company wants to provide a dynamic and custom experience for their various types of users, as a Superadmin you need to identify specific user segments in the platform to target an audience for various Admin actions such as course enrollment, course catalog visibility, page/menu visibility, reporting and notification delivery.
In order to identify specific user segments, you can configure several different user additional fields that capture important user attributes. These fields may include information such as Job Title, Hire Date, Department, Location, Manager, Product, Employee Status, or anything else that may be valuable to track within the platform. With these attributes tracked for each user, you can set up groups with an automatic assignment to automate the process of identifying a user segment. You can set up broad-reaching groups that contain only one rule (for example: The “Sales” group should contain anyone whose job title contains the word “Sales”), and also narrow groups with multiple rules (for example: The “Los Angeles Sales Team New Hires” group should contain all users whose Location is Los Angeles, Job Title is Sales, and Hire Date is after x date). By creating multiple groups, you as a Superadmin can easily target various user segments for use in the platform.
To create a new group, log into the platform as the Superadmin and access the Admin Menu from the gear icon in the top right corner of the platform. In the Admin Menu, press the Groups item in the E-Learning section.
On the main Groups page, press the plus button in the top right corner. In the New Group right panel, assign a name and, optionally, a description to the group. Then, choose the policy for the group’s population process (either manual or automatic) and press Create and Edit.
Manually Adding Users to Groups
If you have selected the option to manually assign users to the group, after the group creation, move to the Users tab and click on Assign Users in the top right corner. Choose now whether you want to populate the group by selecting users individually, by copying the users already assigned to other groups, or by copying users from a branch.
You can repeat the group population procedure several times, using different options.
Once users are added to the group, they are listed in the Users tab of the group main page. In order to remove a user from the group, hover your mouse at the end of the user row, click on the menu button and select Remove.
In order to remove several users at a time from the group, select them by checking the checkbox next to the users’ names, then click on the Choose Action button at the bottom right corner of the page, and select Remove.
It is possible to export the users’ list in CSV format by clicking on the Export Users’ List as CSV button in the top right corner.
A user can be assigned to more than one group. Users of a group can be added or removed at any time.
When selecting the automatic population for a group, after defining the group name and description, you will land on the Properties page of the group. Move to the Eligibility area to create the conditions for the automatic population of the group. Users will be automatically added or removed from the group depending on the conditions you configure.
At any time, you can edit the group name and description in the General section. In the Options section set whether to exclude the deactivated users from being added to the group by the automatic conditions. You will still be able to add deactivated users manually, as described in the Manual Management of Automatic Groups chapter of this article.
You can define up to 50 sets of conditions, each set can include up to 10 conditions. If you are planning to define more than one set, define whether all of them or at least one of them must be met to add users to the group.
Add a new condition by clicking on New Set. In the right panel click on the Condition dropdown and select one of the following options:
- Enrollment Status Based Condition
- Use this condition to assign users to the group depending on their status in a course. As an example, you may want to include all of the users who have completed the Customer Care onboarding course to the Customer Care group. Find out more about enrolling users into courses.
- Branch Based Condition
- Use this condition to assign users to the group depending on the branch they belong to. If multiple branches are selected, the user can belong to any of the included branches to meet the group eligibility. If the selected branch includes sub-branches, they are not selected by default. Include all of the sub-branches in the rule by clicking twice on the checkbox next to the branch name, or select them individually by clicking on the arrow at the end of the branch row and operating your choice.
- User Additional Fields Based Condition
- Use this condition to assign users to the group depending on the value of a user additional field. As an example, if you set a user additional field to collect the hire date of users, you can then automatically populate a group including all of the users hired in 2021. If the number of User Additional Fields exceeds 250, only the first 250 will be listed in the dropdown and available for selection. If a User Additional Field is not listed in the dropdown, look for it by typing in its name and selecting it among the proposed results.
- User Fields Based Condition
- Use this condition to assign users to the group based on the user standard fields:
- Email address
- Automatically assign users to the group depending on whether their email address contains the keyword entered after selecting this option. You can enter a keyword per every condition configured.
- Automatically assign users to the group depending on their selected language in the My Profile area. Remember that if users do not select a language, the platform will automatically assign them the platform default language set in the Localization Tool.
Add the conditions you need to the set and click on Create to confirm its creation.
Repeat the set creation procedure as many times as you need to create different sets. If you have more than one set of rules, select whether all of them or at least one of them must be met to add users to the group using the dropdown menu in the top right corner of the Eligibility area.
When you have configured all of the sets of conditions, click on Save Changes to start the automatic population of the group. Users (including deactivated and expired users) will be added to the group as they satisfy the conditions you have defined and will be listed in the Users tab. Their assignment method will be set to Automatic.
The time needed to complete the group population may change depending on the platform's ongoing activities, on the automatic enrollment rules set for the group, and on the number of users involved in the group creation.
It is possible to export the users’ list in CSV format by clicking on the Export Users’ List as CSV button in the top right corner.
At any time, you can edit or remove your set of conditions by hovering your mouse on the top right corner of the set, clicking on the menu button and selecting Edit or Delete. The group population will be recalculated every time you edit or delete any of the conditions you have configured.
The last 10 versions of the group eligibility conditions are kept in the History tab. Please note that you cannot roll back to previous versions. If you need to revert your changes, you have to re-configure your sets manually.
Manual Management of Automatic Groups
Automatic groups are automatically populated on the basis of the sets of conditions you have configured, but you can still add or remove users from them manually.
In order to manually add users to a group, click on the group description in the Groups management page, and move to the Users tab. Click on the Assign Users button in the top right corner and choose whether you want to populate the group by selecting users individually, by copying the users already assigned to other groups, or by copying users from a branch. You can repeat the procedure several times, using different options. Click Confirm to add the users to the group.
When users are manually added to an automatic group, their assignment method is set to Manual. The users manually added to the group are not subject to the automatic population, based on conditions. They will be kept in the group even if they do not satisfy the population conditions until you remove the manual assignment method by clicking on the ellipsis menu at the end of the user row and selecting the Remove Manual Assignment option.
When you remove the Manual assignment method for a user, the user is removed from the group, unless they satisfy the conditions you have configured for the automatic population of the group. In such a situation, the user will be kept in the group, and his or her assignment method will be set to Automatic.
If you want to assign a user to an automatic group on a permanent basis so that they are kept in the group even if not satisfying its population conditions, switch the user assignment method to Manual by clicking on the ellipsis menu at the end of the user row and selecting the Switch to Manual Assignment option.
In order to remove or to switch to the manual assignment method for several users at a time, select them by checking the checkbox next to the users’ names, then click on the Choose Action button at the bottom right corner of the page and select the appropriate option.
You can manage both manual and automatic groups from the Groups main page. Groups can be only managed individually, performing the same action on a selection of groups is not an option. Click on the ellipsis menu at the end of the group to edit, duplicate or delete the group.
When you duplicate a manual group, you can set whether to copy the users of the source group as users of the new group. When you duplicate an automatic group, users are not copied, but, by selecting the option to use the same eligibility conditions, the rules will be reprocessed to populate the new group. As an option, you can choose to copy the manually-added users.
Since Power Users cannot create automatic groups, they are not allowed to duplicate them. Power Users can only duplicate manual groups.
Associating Users to Groups via CSV Files
As a Superadmin, you can associate users to either a manual or an automatic group using CSV files. To do so, click on the group description on the Groups management page, and click on the Manage Group Associations via CSV button in the top right corner of the page.
A slideout panel will open on the right side of the page for the CSV file upload. For a successful upload, it is important to create a properly formatted CSV file. Download the sample CSV file for an example of file formatting. Once your file is ready, either drag and drop it into the upload section of the slideout panel or click the upload area to find the file. Please note that the maximum file size for CSV files is 3MB.
Once the file is uploaded, press the Advanced Settings title to configure additional options. The system is configured to automatically detect the Field Separator needed in order to organize the information by columns. Information can be divided by a comma, a semicolon, or manually, depending on your needs.
Flag the option to consider the first row as a header, if this fits your CSV file format, and select the File Charset from the dropdown menu. We recommend the UTF-8 charset, which is standard. Please remember to use quotation marks to delimit the text content. Press Confirm to upload your CSV file.
The system will then process your CSV file. Once ready, you will be redirected to the fields mapping page. In the Profiles section, you can select a preset profile from the dropdown menu to associate a previous mapping configuration to this CSV import. Press the Overwrite Current Preset button if you want to save changes to the current preset. Additionally, you can manually map the columns to platform fields (see more hereafter), then save the configuration by pressing the Save this Preset as New button. In the pop-up box, provide a name for the preset, then press Save.
In the Preview section, drag and drop the fields in the Docebo Fields section on the left to match the fields with the column names of your CSV file, then press the Associate Users button at the bottom of the page. Confirm the information in the pop-up message that will be displayed, then click Associate Users.
The association will be carried out with a background job. In case of any errors, an error file will be made available for download. To find this file, access the Admin Menu, then select the Background Jobs item. Find the job in the list to download the file.
The imported users will be listed in the Users tab of the group. Their assignment method will be set as Manual.
Power Users Managing Groups
Depending on the permissions assigned by the Superadmin, Power Users may have some management permissions on groups.
- If a Power User profile has View permissions on groups, the Power Users assigned to the profile will be able to see only the groups assigned to them.
- When the profile has Edit permissions, Power Users will be able to edit the groups’ names and descriptions both for manual and automatic groups. For manual groups, they will also be able to add or remove the users they have visibility on to and from the group. They will not be able to edit the conditions for the population of automatic groups.
- When the Power User profile has Create permissions, the Power Users associated with the profile will be allowed only to create manual groups. The Automatic Creation option will not be available for them at group creation time.