BP Profile Search


BP Profile Search is a member search and member directories plugin for BuddyPress. It provides:

  • A form builder to build the member search forms
  • The [bps_directory] shortcode to customize the BuddyPress Members directory, or to build additional member directories

Search forms can select the BuddyPress Members directory, or one of the member directories built with this plugin, as the target directory to filter. That means that the target directory is searched, and is also used to show the search results.

Build a search form

With the form builder you can:

  • Add, remove, and reorder the search fields
  • Use as search fields the BuddyPress profile fields, the users and usermeta data (including roles), the BuddyPress user groups, and the user taxonomies (including BuddyPress member types)
  • Use search by distance fields when you install the free companion plugin BP Distance Search
  • Select, for each search field, one of the available search modes
  • Select the BuddyPress Members directory, or one of the member directories built with this plugin, as the target directory
  • Select the form template to display your form
  • If in doubt, use the Help tab above the screen title

The form template works just like any other BuddyPress template. To override a form template, copy it to the ‘buddypress/members’ directory in your theme’s root, then edit the new copy according to your needs.

Display a search form

After you build your search form, you can display it:

  • In its target directory, using the option Add to Directory in the form settings
  • In a sidebar or widget area, using the widget Profile Search
  • In a post or page, using the shortcode [bps_form]

Run a search

On the front-end, when you hit the Search button in a form, BP Profile Search opens the form’s target directory and filters it with your search filters. Both the All Members tab and the My Friends tab are filtered.

Additionally, the plugin:

  • Displays an active filters section containing the active search filters and a Clear button to clear them
  • Displays for each member a member details section containing the values of the searched fields
  • Adds to the Order By drop-down the options to sort the directory by the searched fields

The active filters section and the member details section are displayed by two dedicated templates, that can be overridden just like any other BuddyPress template.

Build a member directory

With the [bps_directory] shortcode you can:

  • Customize the BuddyPress Members directory, or build additional member directories
  • Add hidden filters to a directory
  • Add more sort options to a directory
  • Show additional member information in each member details section, e.g. the value of profile fields
  • Use a different Members directory template for each directory

You can enter the shortcode in an empty page to build a new member directory, or you can enter it in the BuddyPress Members page to customize the BuddyPress Members directory.

Additional documentation

Tested up to BuddyPress 5.0.0

In the screenshots below, the City field is provided by the free companion plugin BP Distance Search.


  • The Profile Search Forms admin page
  • The Edit Form admin page
  • Configuration of a Profile Search widget
  • The Members directory page with a Profile Search widget
  • The Members directory page with search results


See the standard installation procedure, in Managing Plugins.


5 Agost 2019
The developer created this amazing search rocks big time! Very compatible with my theme and no error and with nice designed. Very simple settings and straight forward. For the support wise? The words is EXCELLENT. I put in 2-3 support tickets, both are so easy to understand per instructions. Read it, got it! I am giving 10 stars overall. 5 stars for the super plugin and 5 stars for the super support. Please keep up your super search plugin. YOU ROCK BIG TIME IN ALL ASPECTS!!! HAPPY CAMPER!!!
15 Maig 2019
Superb, simple plugin with some minor bugs. Automaticc (BP) committee should integrate it as part of Buddypress, that's for sure.
23 Abril 2019
This plugin is amazing. It's what I was looking for. And a plugin-key for a dating site. Many thanks to Andrea!
Llegiu totes les 48 ressenya

Col·laboradors i desenvolupadors

"BP Profile Search" és programari de codi obert. La següent gent ha contribuït en aquesta extensió.


“BP Profile Search” s'ha traduït a 5 localitzacions. Gràcies als traductos per les seves aportacions.

Tradueix “BP Profile Search” a la teva llengua.

Interessats en el desenvolupament?

Navegueu pel codi, baixeu-vos el repositori SVN, o subscriviu-vos al registre de desenvolupament per fisl de subscripció RSS.

Registre de canvis


  • Added search by group, to find members belonging to the selected group(s)


  • Added the bps-details template, to customize the member details section
  • Removed the bps-field-value template, replaced by bps-details


  • Fixed bug with range and age_range in old templates, introduced in 5.0.2


  • Made the AND and OR keywords translatable in searches
  • Fixed bug with the bps_match_all hook
  • Made the multiple select size adjustable in search forms
  • Minor adjustment to the bps-form-default template
  • See BP Profile Search 5.0.4 for details


  • Fixed compatibility with GEO my WordPress
  • Fixed bug in the [bps_directory] shortcode with values containing ampersand (&)


  • Added display of profile fields in the [bps_directory] shortcode
  • Added display of selected profile fields in search results
  • Added option to sort search results by selected profile fields
  • Fixed a potential privacy problem involving unauthorized searches
  • Improved compatibility with GEO my WordPress
  • See BP Profile Search 5.0.2 for details


  • Fixed critical bug in the [bps_directory] shortcode – wrong links to user profiles


  • Fixed the [bps_directory] shortcode to work with BP Legacy and BP Nouveau
  • Added search modes is and range for date fields
  • Improved compatibility with BP xProfile Location
  • Added notice for users of outdated form templates



  • Fixed workaround to prevent a theme conflict


  • Minor adjustment to the bps-form-default template
  • Workaround to prevent a plugin conflict


  • Restored the bps-form-nouveau template, following user requests


  • Fixed CSS bug with bps-form-default
  • Fixed bug with the Member Type search field


  • Added support for AND and OR expressions in search fields
  • Retired the bps-form-nouveau template, replaced by bps-form-default


  • Fixed bug introduced in 4.9.1 affecting older form templates
  • Added admin error notice when BuddyPress is not active


  • Fixed PHP Warnings in form templates
  • Fixed bug in WPML support


  • Introduced a new default form template, to gradually replace older templates
  • See Form Templates for details


  • Added search by user taxonomies (including BP member types)
  • Added column in the Search Forms page showing the current template and its location


  • Added choice of jQuery UI theme for the bps-form-nouveau template



  • Added a new form template compatible with BP Nouveau
  • Revised the plugin’s contextual help
  • The shortcode [bps_directory] still doesn’t work with BP Nouveau
  • See BP Profile Search 4.8.3 for details


  • Fixed issue when calling a template inside a template


  • Added ability to search by data in the users table
  • Added option to enable or disable persistent search
  • Removed the old interface for custom field types
  • See BP Profile Search 4.8.1 for details



  • Introduced new search mode is one of



  • No longer clears the search when leaving the members directory
  • Removed PHP Warning during first activation
  • Added HTML class to forms in form templates
  • Added configuration file for WPML


  • Fixed bug with custom field types introduced in 4.7.5


  • Moved the search mode selection to the field level


  • Fixed bugs in WPML support


  • Added filter to change the cookie name


  • Fixed bug with custom field types introduced in 4.7.1


  • Modified the Form Fields settings UI to enable further development



  • Added support for WPGlobus
  • Updated templates for the Twenty Seventeen theme
  • Added the plugin icon – by Alexei Ryazancev


  • Added ability to search for member types
  • Added the filters bps_clear_search and bps_match_all


  • Added support for member-type directories
  • Updated templates to allow member-type directories as results pages


  • Removed insecure code – thanks to Robert Rowley at pagely.com


  • Fixed hardcoded strings in a form template


  • Fixed bug in Age Range display introduced in version 4.5
  • Fixed bug in label display introduced in version 4.5.1


  • Fixed order of search conditions in directory pages
  • Improved support for WPML


  • Added generic search field to search every profile field


  • Added basic support for WPML


  • Fixed the Form Action (Results Directory) drop down list


  • Fixed bug with member-type specific fields


  • Fixed bug in wildcard searching


  • Updated to use WP language packs


  • Fixed rendering of hidden fields in form templates


  • Updated templates to better support custom field types
  • Updated documentation for custom field types authors


  • Updated for WordPress 4.3


  • Restricted capability to create forms to admin only
  • Added the filters bps_form_order and bps_form_caps
  • Changed the name of a few functions


  • Updated templates to work in member-type directories


  • Fixed bug when searching in a multiselectbox profile field type


  • Added ability to use form templates


  • Fixed bug with field labels containing quotes


  • Added ability to create custom Members directory pages
  • Added ability to use them as custom search results pages


  • Fixed PHP fatal error when BP component Extended Profiles was not active
  • Replaced deprecated like_escape()


  • Fixed PHP warning when using the SAME search mode


  • Fixed bug with field options not respecting sort order
  • Fixed bug with search strings containing ampersand (&)


  • Added support for multiple forms
  • Added ability to export/import forms
  • Added selection of the form method attribute
  • Updated Italian and Russian translations


  • Added French translation


  • Fixed bug when searching in a number profile field type


  • Added support for custom profile field types, see documentation


  • Reduced the number of database queries


  • Updated for the number profile field type (BP 2.0)


  • Fixed PHP warnings after upgrade


  • Redesigned settings page, added Help section
  • Added customization of field label and description
  • Added Value Range Search for multiple numeric fields
  • Added Age Range Search for multiple date fields
  • Added reordering of form fields
  • Updated Italian translation
  • Updated Russian translation


  • Replaced deprecated $wpdb->escape() with esc_sql()
  • Added Clear link to reset the search filters


  • Fixed the CSS for widget forms and shortcode generated forms


  • Added Serbo-Croatian translation


  • Added Spanish, Russian and Italian translations


  • Fixed a pagination bug introduced in 3.5.1


  • Fixed a few conflicts with other plugins and themes


  • Added the Add to Directory option
  • Fixed a couple of bugs with multisite installations
  • Ready for localization
  • Requires BuddyPress 1.8 or higher


  • Added selectbox profile fields as candidates for the Value Range Search


  • Added the Value Range Search option – thanks to Florian Shießl


  • Added pagination for search results
  • Added searching in the My Friends tab of the Members directory
  • Removed the Filtered Members List option in the Advanced Options tab
  • Requires BuddyPress 1.7 or higher


  • Updated for BuddyPress 1.6
  • Requires BuddyPress 1.6 or higher


  • Fixed the search when field options contain trailing spaces
  • Fixed the search when field type is changed after creation


  • Added the Profile Search widget
  • Added the [bp_profile_search_form] shortcode


  • Fixed the Age Range Search
  • Fixed the search form for required fields
  • Removed field descriptions from the search form
  • Requires BuddyPress 1.5 or higher


  • Updated for BuddyPress 1.5 multisite
  • Requires BuddyPress 1.2.8 or higher


  • Updated for BuddyPress 1.5


  • Updated for BuddyPress 1.2.8 multisite installations


  • Added the Filtered Members List option in the Advanced Options tab


  • Added the choice between Partial match and Exact match for text searches


  • Added the Age Range Search option


  • Added the Toggle Form option to show/hide the search form
  • Fixed a bug where no results were found in some installations


  • Added support for multiselectbox and checkbox profile fields
  • Added support for % and _ wildcard characters in text searches


  • First version released to the WordPress Plugin Directory