Skip to content
Docs

Field Settings

Field Settings

Section titled “Field Settings”

Go to WB Plugins > Profile Pro > Field Settings to access these settings.

This tab is where you create and configure individual profile fields. Fields live inside groups. You need at least one group before you can add fields. See Group Settings if you have not created any groups yet.

Browsing existing fields

Section titled “Browsing existing fields”

The left column shows all your groups as tabs. Click a group name to see the fields inside it. Each field appears as a row showing its title. Click the gear icon to expand a field’s settings. Click the trash icon to delete a field.

Drag field rows up or down to reorder them within a group. The order here determines the order they appear on the member’s form and profile view. Click Save Settings after reordering.

Field properties

Section titled “Field properties”

Field Title

Section titled “Field Title”

The label shown to members next to this field on the form and in the profile view. For example, “Employer Name”, “City”, “LinkedIn URL”.

Field Type

Section titled “Field Type”

Determines what kind of input members see. Available types:

Type Description
Textbox Single-line text input.
Textarea Multi-line text input.
Select Dropdown with predefined options you define.
Year Dropdown Dropdown pre-populated with years (50 years back and 50 ahead from the current year).
Textbox & Dropdown Combination A paired text input and dropdown in one field.
Google Place Autocomplete Location search field powered by the Google Places API. Requires an API key in General Settings.
Calendar Date picker using jQuery UI datepicker.
Selectize Tag-style multi-select. Members can pick multiple values from predefined options.
Checkbox One or more tick boxes from predefined options.
Radio Button Single selection from predefined options displayed as radio buttons.
Email Text field validated as an email address.
Phone Number Text field for phone numbers.
URL Text field for web addresses.
Image Image upload field. Note: image fields are excluded from the Profile Search form.

For Select, Year Dropdown, Selectize, Checkbox, Radio Button, and Textbox & Dropdown, you define the available options in the Field Options section that appears after choosing the type.

Field Description

Section titled “Field Description”

Text displayed below the input on the frontend form when Show field descriptions is enabled in General Settings. Use this to give members guidance on what to enter.

Field Options

Section titled “Field Options”

Appears only for types that need predefined choices (Select, Checkbox, Radio Button, Selectize, Textbox & Dropdown). Enter one option per line. Click the + icon to add more option rows and the trash icon to remove one.

Display

Section titled “Display”

When checked, this field is included in the extended-fields form shown to members. Uncheck to hide a field from the form without deleting it.

Required

Section titled “Required”

When checked, members cannot save the form without filling in this field. Use sparingly — requiring too many fields discourages members from completing their profile.

Repeater

Section titled “Repeater”

When checked, this field is treated as a repeater field. Repeater fields allow members to submit multiple values for the same field. This is most useful inside a repeater group (for example, listing multiple employers).

If the parent group is already set as a repeater, all fields in it behave as repeaters regardless of this individual setting.

Show on register page

Section titled “Show on register page”

When checked, this field appears on the BuddyPress member registration form. This option is hidden for fields inside repeater groups, since repeater data cannot be collected at registration.

Group Key, Field Key, Meta Key

Section titled “Group Key, Field Key, Meta Key”

Read-only reference values with a Copy button. These are the internal identifiers used when accessing field data programmatically.

  • Group Key — the key for the parent group (for example, bprm_grp_edu).
  • Field Key — the key for this specific field (for example, bprms_inst).
  • Meta Key — the WordPress user meta key where this field’s value is stored (format: wbbpp_<group_key>_<field_key>).

Use these keys in custom templates, filters, or REST API integrations.

Changing a field type

Section titled “Changing a field type”

You can change a field’s type from the Type dropdown. When you change to a type that requires predefined options (Select, Checkbox, etc.), the Field Options section appears. Previously saved member data for the old type is preserved but may not display correctly with the new type if the stored format does not match.

Adding a new field

Section titled “Adding a new field”

The right column contains the Add New Field form.

  1. Enter a Field Title (required).
  2. Choose a Field Type from the dropdown.
  3. Optionally enter a Field Description.
  4. If the type needs options (Select, Checkbox, etc.), define them in the options section that appears.
  5. Choose the Field Group this field belongs to.
  6. For certain field types, additional options appear: Field Section Title (used for grouping appearance on the profile), Appearance Section (Content Area or Sidebar), and Field Section Icon (a Font Awesome 4.7 class like fa fa-graduation-cap).
  7. Check Display to make the field visible in the extended-fields form (checked by default).
  8. Check Required if members must fill this field.
  9. Check Repeater if members should be able to add multiple values.
  10. Check Show on register page if this field should appear on the registration form.
  11. Click Add.

The field is created via an AJAX request and appears in the group’s field list on the left.

After saving

Section titled “After saving”

Click Save Settings to save field property changes. The button is at the bottom of the left column form. The new field order (after dragging) is also saved here.

Field changes apply immediately to the frontend extended-fields form. Members who open the form after you save will see the updated fields.

Section titled “Related docs”