Note: You are currently viewing documentation for Moodle 2.9. Up-to-date documentation for the latest stable version of Moodle may be available here: Category enrolments.

Category enrolments

From MoodleDocs

The category enrolments plugin allows users to be enrolled in a category as opposed to individual courses. The plugin has to be enabled by the site administrator (see Enrolment plugins). The category enrolment plugin will synchronise any role assignments at category context with the capability enrol/category:synchronised set to allow.

Note: It is recommended that Cohort sync is used in preference to category enrolments. There are performance issues with category enrolments. See

Settings for category enrolment

  • Go to the category into which you wish to enrol users. Note: You need to have category rights (manager or administrator)
  • In the Administration block,click Assign roles. The list of possible roles you can assign will appear:


NOTE: The roles you see here are roles which have been assigned at the category context and which you are able to assign, ie, the role has been checked in Site administration>Accounts>Users>Permissions>Define roles>Allow role assignments.

Admin settings for category enrolment

The category enrolment plugin may be enabled or disabled throughout the site in Administration > Site administration > Plugins > Enrolments> Manage enrol plugins.

Assigning teachers or students to a category

  • By default, only managers and course creators can be assigned category-wide. If you want to add teachers or students then the site administrator needs to tick the "category" box in their role in Administration > Site administration > Users > Permissions > Define roles.
  • To ensure they will be automatically assigned as teachers/students in any new courses you make, the administrator needs to set to "allow" the capability enrol/category:synchronised for the role in question in Administration > Site Administration > Users > Permissions > Define roles.


Allowing teachers to assign category roles

If you wish teachers to be able to assign roles in the category context, you must ensure that the selected roles are available in the category context and that your category teacher role has the selected role checked in Site administration>Accounts>Users>Permissions>Define roles>Allow role assignments. If you simply assign a teacher to a category without taking these extra steps, then they will see a message "You cannot assign roles" when clicking Category administration>Assign roles. See also MDL-23839