Plugin Directory

Test out the new Plugin Directory and let us know what you think.

BP Profile Search

Let visitors search your BuddyPress Members Directory and their Friends list.

After the standard plugin installation procedure, you'll be able to access the plugin settings page Users -> Profile Search, where you can build and customize your search forms.

Form Fields

In this section you can:

  • Add and remove form fields
  • Enter the field label and description, or leave them empty to use the default
  • Enable the Value Range Search for numeric fields, or the Age Range Search for date fields
  • Change the order of the fields

Form Attributes

In this section you can select your form's method attribute:

  • POST: the form data are not visible in the URL and it's not possible to bookmark the results page
  • GET: the form data are sent as URL variables and it's possible to bookmark the results page

You can also select your form's action attribute. The action attribute points to your form's results page, that could be:

  • The BuddyPress Members Directory page
  • A custom Members Directory page

You can create a custom Members Directory page using the shortcode [bps_directory], and you can even use a custom directory template. To learn more, read the Custom Directories tutorial.

Add to Directory

With this option you can insert your search form in its Members Directory page. If you enable Add to Directory, you can also:

  • Select the form template to use
  • Enter the HTML text for the optional form header
  • Enable the Toggle Form option
  • Enter the text for the Toggle Form button

Text Search Mode

With this option you can select your text search mode. The modes are:

  • contains: a search for John finds John, Johnson, Long John Silver, and so on
  • is: a search for John finds John only
  • is like: same as above, but with optional wildcard characters

In the last mode, the allowed wildcard characters are:

  • Percent sign (%): matches any text, or no text at all
  • Underscore (_): matches any single character

Display your search form

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

  • In its Members Directory page, selecting the option Add to Directory
  • In a sidebar or widget area, using the widget Profile Search
  • In a post or page, using the shortcode [bps_display form=id template=tpl] (*)
  • Anywhere in your theme, using the PHP code
    <?php do_action ('bps_display_form', id, tpl); ?> (*)

(*) Replace 'id' with your actual form ID, and 'tpl' with the name of the form template you want to use.

Requires: 4.2 or higher
Compatible up to: 4.6.1
Last Updated: 6 days ago
Active Installs: 10,000+


5 out of 5 stars


3 of 11 support threads in the last two months have been marked resolved.

Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,1,1
50,2,1 100,1,1