Form Builder


Build a search form

You can build your search forms in the admin page Users -> Profile Search. If you need help, use the Help tab above the screen title.

To create a new form, use the button Add New. You can then enter the form title, add the form fields, specify the form settings and select the form template.

Form Fields

In this section you can add, remove and reorder the fields of your search form.

  • Customize the field label and description, or leave them empty to use the default
  • Select the field search mode from the Search Mode drop-down list
  • To reorder the fields in the form, drag them up or down by the handle on the left
  • To remove a field from the form, click Remove on the right
  • To leave a field description blank, enter a single dash (-) character

For additional information on search modes, see the Search Modes page.

[back to Contents]

Form Settings

In this section you can specify the form settings.

Target Directory
Select the member directory that will be filtered using this search form. You can choose:

  • The BuddyPress Members directory
  • One of the member directories built with this plugin

You can create a member directory using the shortcode [bps_directory]. To learn more, see the Custom Directories page.

Add Form to Directory
Choose whether to display this form in its target directory.

Form Method
Select your form’s method attribute, POST or GET.

With the GET method, the submitted search is contained in the target directory URL. Your visitors can bookmark their search results to save the submitted search and run it again later.

With the POST method, the submitted search is not contained in the target directory URL, and it’s not possible to save it using a bookmark.

Regardless of this setting, you can put a URL containing a search in a link or menu item on your site. Your visitors will then be able to run the search visiting that link.

[back to Contents]

Form Template

In this section you can select how to display your search form.

  • Select the form template
  • Specify the template options, if any

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. To learn more, see the Form Templates page.

[back to Contents]

Persistent Search

In this section you can enable or disable the persistent search feature.

  • If enabled, a search is cleared when the user hits the Clear button
  • If disabled, a search is cleared when the user hits the Clear button, or navigates away from the target directory

This selection applies to all your forms at once.

[back to Contents]

Display a search form

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

  • In its target directory, using the option Add Form to Directory
  • In a sidebar or widget area, using the widget Profile Search
  • In a post or page, using the shortcode [bps_form id=form_id] (*)

(*) Replace form_id with the actual ID of your form.

[back to Contents]


This page has been updated for BP Profile Search 5.2.3 (December 5, 2019). If you have suggestions for improvement, if you need help, or if something is not working for you as expected, please use the Support Forum.