BuddyPress Friends Suggestions Pro

BuddyPress Friends Suggestion Pro helps you enhance your BuddyPress or BuddyBoss Platform-based social network by providing friends and follow suggestions for your users.

If you are looking for a friends suggestions widget similar to Facebook's "People you may know " widget, this plugin is a suitable choice for you. You can create suggestions based on user profile data.

The plugin provides you with options to create one or more rule set for matching. Each profile matching rule set can have one or more rules based on user profile field data. The plugin suggests friends/followers by matching the current logged user's profile data with the other user's profile data.


  • Multiple friends suggestions list based on BuddyPress or BuddyBoss user profile data.
  • Multiple Follow suggestions list based on BuddyPress or BuddyBoss user profile data. For BuddyPress, you will need the BuddyPress Follow plugin.
  • Can be used to show one or more Friends or Follow suggestions list in a widget for the logged-in user.
  • You can create any number of the match ruleset and use them in the widget
  • Each rule set may contain multiple matching conditions. You can use various operators to declare how to match.
  • You can specify how to consider a match(should we consider a match if all the conditions match or anyone condition match)
  • It works with BuddyPress & BuddyBoss platform well.


Friends and Follow suggestions list for BuddyPress:-

Friends and Follow suggestions list for BuddyBoss platform and theme:-

Admin Screens:-


How to use:-

To display suggestions, you will need to first create the rule and then use these rules in the widget.

Creating Friends/Follow suggestions Rules:-

  • Please Login to the dashboard as a site administrator
  • Visit Dashboard->Users-><Friends Suggestions Rules
  • Click on "Add New"
  • Add one or more rules from the page. Select "Enabled" in the right and "Publish" the rule as shown in the below screenshot.


Showing the Friends/Follow suggestions in a widget:-

  • Please visit Dashboard->Appearance->Widgets
  • Add "BP Friends Suggestion Pro" to your widget area
  • Add a title, select "Follow or Friends" from the dropdown and select the ruleset to be used
  • Save and that's it.
  • Have fun. Here is a screenshot of the widget options.


Showing the Friends/Follow suggestions using the shortcode:-

Shortcode: [bp_friends_suggestions]

Support parameters:

  • user_id: Friends suggestions for the targeted user.
  • context: Possible values are logged_indisplayed. Default value logged_in.
  • limit:    How many suggestions to show. Need user login to reflect changes after the update.
  • rule:    Rule id to be applied.
  • type:    Suggestions type i.e. friendsfollow. Default value friends

Frequently Asked Questions:-

Can I create multiple suggestions list?

Yes, You can create as many suggestions list as you want.

Can I show suggestions for Friends & follow both

Yes, you can show suggestions for friends and follow both. You can specify a ruleset and suggestion type in the widget. In order to show Friends, and Follow suggestions, you should use two widgets, one with "Friends" suggestions and another with Follow suggestion.

I do not see the suggestion type dropdown(Friends/Follow) in the widget?

The dropdown is only available f both Friends and follow are enabled. If you are using the BuddyBoss platform, Please make sure "Follow" is enabled. If you are using BuddyPress, Please make sure you are using the BuddyPress Follow plugin.

Does it work with BuddyPress Legacy & BuddyPress Nouveau template packs?

Yes, It works with both.

Does it work with BuddyBoss Theme?

Yes, it works nicely with the BuddyBoss theme.

Is there a limit on the number of rules/conditions I should use for a ruleset?

There is no limit. But we do not recommend using more than 4 conditions. Profile data search is an expensive operation and keeping the number of conditions low improves the speed. We do cache the results for hours to further save the resources.

I have updated the rule but suggestions are not changing?

We cache the suggestions for an hour for a user for a specific ruleset. When you update this ruleset, the suggestions cache for the user is not cleared. The changes will be only visible after the current cache expires.

How to force update suggested friends/followers list after a rule change:-

Suggestions cache for a user is cleared when:-

  • user profile data is updated, the cache is cleared and the list is rebuilt.
  • A user adds another user as a friend.
  • A user cancels a friendship.
  • A user follows another user.
  • A user unfollows another user.

Another option to globally clear the cache is by creating a new rule-set and using this new rule set in the widget. Since the suggestions are cached based on user and rule set, replacing rule-set forces rebuilding of the suggestions list.

Release History

  • Version: 1.1.2

    Tuesday, 20 February, 2024
    • Tested With: BuddyPress 12.2.0
    • Compatible With: BuddyPress 8.0+

    Bumping version to regenerate archive for WordPress 6.4.3 compatibility.

  • Version: 1.1.1

    Friday, 15 December, 2023
    • Tested With: BuddyPress 12.0
    • Compatible With: BuddyPress 8.0+

    Fix selected matching criteria in admin

  • Version: 1.1.0

    Saturday, 29 July, 2023
    • Tested With: BuddyPress 11.2.0
    • Compatible With: BuddyPress 8.0+

    Security Fix: Autherization bug allowed non admins to create lists. The update restricts list creation/update by admin only.
    Fix:- Compatibility with PHP 8.1

  • Version: 1.0.6

    Sunday, 03 July, 2022
    • Tested With: BuddyPress 10.3.0
    • Compatible With: BuddyPress 7.0+

    Fix limit result as per widget settings.

  • Version: 1.0.5

    Wednesday, 09 June, 2021
    • Tested With: BuddyPress 8.0.0
    • Compatible With: BuddyPress 7.0+

    Added compatibility with Widget Options plugin

  • Version: 1.0.4

    Friday, 12 March, 2021
    • Tested With: BuddyPress 7.2.0
    • Compatible With: BuddyPress 6.0+

    Fixed: Notice when multi valued fields were used for suggestions(checkbox or multi select)
    New: Added an option in the widget to hide if no suggestions are available.

  • Version: 1.0.3

    Thursday, 04 March, 2021
    • Tested With: BuddyPress 7.2.0
    • Compatible With: BuddyPress 4.0+

    Randomize users list

  • Version: 1.0.2

    Wednesday, 13 January, 2021
    • Tested With: BuddyPress 7.1.0
    • Compatible With: BuddyPress 4.0+

    Added shortcode support
    Fix number of suggestions listing issue

  • Version: 1.0.1

    Friday, 18 September, 2020
    • Tested With: BuddyPress 7.0.0
    • Compatible With: BuddyPress 4.0+

    Fix issue with excluding already followed users.

  • Version: 1.0.0

    Tuesday, 18 August, 2020
    • Tested With: BuddyPress 6.2
    • Compatible With: BuddyPress 4.0

    Initial release