Roles and who can pick what
BuddyPress Member Type overviewFreeGet BuddyPress Member Type →
A member type can carry a WordPress role. This page explains which types members can give themselves, which only you can assign, and how to change that.
The rule
Section titled “The rule”On the registration form and on Edit Profile, members are offered only the types that pass both checks:
- The type is flagged for that screen (Display in Registration Form or Display inside Edit Profile Settings; on BuddyBoss, Allow users to self-select on the profile type).
- The type’s role grants no more than an Author can.
A type with no role mapped (Select Role) passes the second check. The server enforces the same list when the form is saved, so a type that is not offered cannot be sent in by hand.
| Mapped role | Members can pick it |
|---|---|
| None (Select Role) | Yes |
| Subscriber | Yes |
| Contributor | Yes |
| Author | Yes |
| Editor | No |
| Administrator | No |
| A custom role with any capability beyond the Author set | No |
“Beyond the Author set” means a capability other than read, edit_posts, delete_posts, upload_files, edit_published_posts, publish_posts, delete_published_posts and the level_0 to level_2 capabilities. For the stock Subscriber, Contributor and Author roles only core WordPress capabilities are counted. An LMS plugin that adds its own capabilities to those roles does not make them blocked. For every other role, plugin capabilities count too.
The rule judges the role, not capabilities added to a single user, and it leaves a member’s existing user-level capabilities untouched.
What happens to a member’s role
Section titled “What happens to a member’s role”- A member who has no role above Author gets the type’s role when they add a type. A Subscriber who picks a type mapped to Author becomes an Author.
- A member who holds a higher role, such as Editor, keeps their role when they pick a type. This includes Administrators.
- Removing a type leaves the role as it is.
- A profile save that leaves the type unchanged never changes the role, for a member or for an administrator, so a role you set by hand stays.
- Types you assign yourself (the user’s profile in wp-admin, or the Users bulk action) apply the mapped role as soon as the type changes, whatever the role is. Administrators are never stripped of their role.
The notice on the type screens
Section titled “The notice on the type screens”When a type is flagged for members and its role blocks it, administrators see a warning on the Users > Member Types list and edit screens (on BuddyBoss, the Profile Types screens). It says how many types are blocked and, once opened, lists each type with its role and the first capabilities that block it. The edit screen of the type also says “This type will not be assignable by members because its role is privileged.”
The same notice turns into an information message when members can pick a type whose Subscriber, Contributor or Author role carries plugin capabilities that the rule does not count. It lists those capabilities.
Let members pick a blocked type anyway
Section titled “Let members pick a blocked type anyway”Add this to a code snippet or your child theme’s functions.php. Replace editor with the role slug the notice names:
add_filter( 'bp_member_type_self_service_blocked_caps', function ( $caps, $role ) { return in_array( $role, array( 'editor' ), true ) ? array() : $caps;}, 10, 2 );The filter receives the capabilities that block the role, the role slug and, as a third argument, the plugin capabilities on a stock role that the rule ignores. Return an empty array to allow the role, or a list to block only those capabilities. To block a stock role because of its plugin capabilities, merge the third argument into the first:
add_filter( 'bp_member_type_self_service_blocked_caps', function ( $caps, $role, $ignored ) { return 'subscriber' === $role ? array_merge( $caps, $ignored ) : $caps;}, 10, 3 );Allowing a role this way means any member can give themselves that role. Use it only when that is what you want.
Example setup: students, teachers, partners
Section titled “Example setup: students, teachers, partners”| Type | Mapped role | Registration form | Edit Profile | Directory |
|---|---|---|---|---|
| Student | Subscriber | Offered, pre-selected | Offered | Tab |
| Teacher | Author | Offered | Not offered | Tab |
| Partner | Editor | Not offered (blocked by role) | Not offered | Tab |
- Create the three types under Users > Member Types and set each Associated Roles value.
- Add one Member Type field under Users > Profile Fields with Signups ticked.
- Tick Display in Registration Form on Student and Teacher, and Pre-select on registration? on Student.
- Assign Partner yourself from the user’s profile or the Users bulk action. Members never see it as a choice.

