Skip to content

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.

On the registration form and on Edit Profile, members are offered only the types that pass both checks:

  1. 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).
  2. 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.

  • 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.

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.

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
  1. Create the three types under Users > Member Types and set each Associated Roles value.
  2. Add one Member Type field under Users > Profile Fields with Signups ticked.
  3. Tick Display in Registration Form on Student and Teacher, and Pre-select on registration? on Student.
  4. Assign Partner yourself from the user’s profile or the Users bulk action. Members never see it as a choice.