BuddyPress User Badges

BuddyPress User Badges adds badge functionality to BuddyPress based communities. This plugin allows you to create any number of custom badges and assign these badges to users. The badges can be assigned manually or automatically. These badges will shown in BuddyPress member list as well as profile page.

Why badge:- Badges can be  a great way to show appreciation to your users. It adds a sense of difference, a sense of belonging. You can give badges to make your users feel special. Having the badge functionality adds that x-factor to your community. Here are some example use of badges:-  You can create badges for top performer, best cricketers, footballers, best student, teacher and so on. Feel free to use your own imagination.

Plugin features:-

  • Custom Badges:- Custom badges can be created and assign to users. For example, you can create a badge with the icon of bat and assign to all baseball lovers.
  • Sortable Badges:- Custom badges can be sorted using drag and drop. You as a BuddyPress Site admin, can control the order in which a badge is shown on a user’s profile. The position will reflect on front end listing of badges.
  • Multiple Badges:- You can create and assign as many badges as you like.
  • Member Type Based Badges:- If you are using member types(you may want to explore the awesome Member Types pro plugin), You can add badges for each member types. All users with the member type will get the badges applicable to their member type. Member type badges can be enabled/disabled per member type.
  • Role Based Badges:- You can assign badges to WordPress roles. All users with the role will get the badge assigned to them. Role based badge can be enabled/disabled for each role.
  • Activate/Deactivate Badge:- You can mark a badge as active or deactive when you need.
  • Role/Member type Badge position:- Role and Member type badges position can be changed using settings. Site admin can select ‘before’ or ‘after’ custom badge options.
  • Screen to show Badges:- Badges can be shown to selected screen by use of settings. Options are Members directory, Group members listing or Single user profile.
  • Badge Position:- Badge position can be set using settings. Available options are Before and After name.
  • You can upload a png/jpg or svg to use as the icon. By default, we use 32 px but you can control it via css.

Screen Shots:-

Admin settings screen:

Admin Badges Screen:

Add new Badge form:

Role Based Badges:

Member Type Based:

Members Listing page:

Single User:



For the demonstration purpose, we used icons from Twemoji set.

Restrict Image dimension with css.

You can add custom CSS by visiting Dashboard->Appearance->Customize and clicking on the “Additional CSS”. You can set any dimension as you please . In the below example, I am setting it to 32px;


You can use the shortcode [bp-user-badges] to list all members with a specific badge.

The shortcode provides following options:-

slug:- It is required. It is the slug of the badge. For Role/Member types based badge, It is the role name e.g “administrator” or the member type name.

Example:- List all members with badge slug “king”

[bp-user-badges slug='king']

context:- Optional. Only required when listing for role or member type based badges. Possible values are ‘role’ or ‘member_type’

Example:- List  5 users who have badges for “Author” role(or who have author role).

[bp-user-badges slug='author' context='role' max=5]

Example:- List 5 users who have “student” member type badge.

[bp-user-badges slug="student" context="member_type" max=5]

You should not specify context for custom badges.

view:- Optional. Possible values are “list”, “default”. It decides how the list will be displayed as a block of avatar of a vertical list of users.


[bp-user-badges slug="king" view="list"]

max:- Maximum number of users to list


[bp-user-badges slug="king" max=5]



Release History

  • Version: 1.1.6

    Tuesday, 07 July, 2020
    • Tested With: BuddyPress 6.1
    • Compatible With: BuddyPress 4.0+

    Fix number of badges shown for the user.

  • Version: 1.1.5

    Saturday, 27 June, 2020
    • Tested With: BuddyPress 6.0
    • Compatible With: BuddyPress 4.0+

    Better compatibility with BuddyBoss theme.

  • Version: 1.1.4

    Sunday, 24 May, 2020
    • Tested With: BuddyPress 6.0
    • Compatible With: WordPress 4.0+

    Update shortcode to list users having a specific role/member type badge correctly.

  • Version: 1.1.3

    Friday, 22 May, 2020
    • Tested With: BuddyPress 6.0
    • Compatible With: BuddyPress 4.0+

    Add shortcode support with 2 views.

  • Version: 1.1.2

    Tuesday, 19 May, 2020
    • Tested With: BuddyPress 6.0
    • Compatible With: BuddyPress 4.0

    Css fix for shortcode members listing

  • Version: 1.0.6

    Thursday, 14 May, 2020
    • Tested With: BuddyPress 5.2
    • Compatible With: BuddyPress 4.0

    Avoid space if badges can be shown in members list for BuddyBoss platform

  • Version: 1.0.5

    Monday, 11 May, 2020
    • Tested With: BuddyPress 5.2
    • Compatible With: BuddyPress 4.0

    Fix badges list in the members list under user profile(friends/followers etc).

  • Version: 1.0.4

    Sunday, 10 May, 2020
    • Tested With: BuddyPress 5.2
    • Compatible With: BuddyPress 4.0

    Fix php notice for array.
    Add better compatibility with BuddyBoss.

  • Version: 1.0.3

    Wednesday, 04 September, 2019
    • Tested With: BuddyPress 5.0
    • Compatible With: BuddyPress 3.0+

    Fix positioning issue between custom badges and role bade or member type based badges.
    Include default css style for badge list(minimal).
    Add option to disable default css in settings.

  • Version: 1.0.2

    Friday, 30 August, 2019
    • Tested With: BuddyPress 4.4
    • Compatible With: BuddyPress 3.0+

    Remove the hardcoded dimension from the images. If you need to restrict height and width of the images, Please see plugin page.

  • Version: 1.0.1

    Wednesday, 10 July, 2019
    • Tested With: BuddyPress 4.4
    • Compatible With: BuddyPress 2.5+

    Fix Badge image not saving for roles.

  • Version: 1.0.0

    Tuesday, 02 July, 2019
    • Tested With: BuddyPress 4.3.0
    • Compatible With: BuddyPress 2.5+

    Release notes