Skip to content

These tasks are all performed from the WordPress admin. They assume BuddyPress and its Extended Profiles (xProfile) component are active.

  1. Go to Users > Member Types.
  2. Fill in the Add New Member Type form: enter the name and the singular and plural labels.
  3. In Associated Roles, choose the WordPress role members of this type should receive. Leave it on Select Role to skip role mapping for this type.
  4. Tick the display options you want (see the sections below).
  5. Click Add New Member Type.

To change the role later, open the type from the member types list and update Associated Roles on the edit screen, then save. Choosing Select Role (the empty option) and saving removes the role mapping for that type.

Let members pick their type on their profile

Section titled “Let members pick their type on their profile”
  1. Go to Users > Profile Fields.
  2. Add a new field. For the field type, choose:
    • Member Types for a multiple-selection (checkbox) field, or
    • Member Type for a single-selection (radio) field.
  3. You do not need to enter options. The field is filled automatically from your member types.
  4. Save the field.
  5. On the field’s edit screen, use the Field Display Control metabox to tick Show Member Type field in user profile if you want members to see and change the field on the front end. Leave it unticked to keep the field off the members’ Edit Profile screen while administrators still manage it in wp-admin.

When a member saves this field, the plugin sets their BuddyPress member type to match and applies the associated WordPress role.

A type appears on the registration form only when all three of these are set:

  1. On the type: go to Users > Member Types, edit the type, tick Display in Registration Form, and save. Optionally tick Pre-select on registration? so the type is checked by default for new visitors.
  2. A profile field: add a Member Types or Member Type field under Users > Profile Fields as described above.
  3. BuddyPress only - the Signups tick on that field: on the field’s edit screen, find the Signups box and tick Use this field in the site registration form. Save the field.

The list above is for BuddyPress only. If any one of the three is missing on BuddyPress, the type does not appear.

On BuddyBoss Platform the rule is different. Our Display in Registration Form checkbox does not apply there, because BuddyBoss hides the member type screen it lives on. Instead:

  1. Go to BuddyBoss > Settings > Profiles > Profile Types and turn on Enable profile types.
  2. Edit the profile type (Add New / Edit Profile Type), and in the Profile Field section tick Allow users to select this profile type from the “Profile Type” dropdown.
  3. Keep the Member Type field in the Base profile group; in any other group it is not shown on registration.
  4. Make sure site registration is enabled.

See Troubleshooting for the full list of cases.

On BuddyPress, only types flagged for registration are offered as options, and on both platforms a type whose mapped role is above Author (for example Editor) is never offered to members on the form.

  1. Go to Users and open the user to edit.
  2. Open the extended profile screen of that user.
  3. Change the Member Type or Member Types field and save.

Administrators who can promote users get the mapped role applied when the type changes. A save that leaves the type as it was never touches the role, so a role you set by hand stays. To clear a type, untick it in the Member Types (checkbox) field, or use Remove member type in the bulk action below. Removing a type does not change the user’s role.

When a single-selection Member Type field exists, the plugin removes BuddyPress’s own member type box from this screen, so the two controls do not conflict. A developer can keep the box with the bp_member_type_remove_membertype_metabox filter.

Show the type in front-end profile settings

Section titled “Show the type in front-end profile settings”
  1. Edit the member type under Users > Member Types.
  2. Tick Display inside Edit Profile Settings.
  3. Save.

Only types flagged for profile settings appear in the member type field on the front-end edit-profile screen. The field itself must also be shown to members: its Field Display Control box has Show Member Type field in user profile, which is on by default for new fields.

  • A member type shows up as a members directory tab automatically once it has a directory and at least one member. No extra step is needed. The number on the tab is counted the same way as the default directory list, so it matches the members the tab shows.
  • To keep a type out of the directory listing, edit the type and tick Exclude from Members Directory, then save. Excluded types are hidden from the default directory, from the tabs and from the All Members count for everyone except administrators. Other members lists on the site, such as a shortcode that asks for the type by name, hide the type too. Saving the type rebuilds the exclusion list.
  1. Go to Users (the WordPress Users table).
  2. Tick the users you want to change.
  3. In the BuddyPress Change member type to control, choose the target type (or Remove member type to clear it).
  4. Apply the bulk action.

Each selected user is given the type and the mapped role. You need the promote_users capability to run this action. On BuddyBoss Platform the bulk change is BuddyBoss’s own, and the member type fields follow it.