The Memberships > Settings > User fields admin page allows you to create new user fields for members.

  • Create field groups that organize user fields with similar settings like ‘show a checkout’ and ‘show on profile’. Groups can be shown for users on the frontend user profile page or be visible and editable for admins only.
  • Create individual fields and define the field type, label, field requirements, help text, and more.

This documentation explains every setting for a Group and single User Field so that you can make the most of this robust feature.

Screenshot of the User Fields admin settings page in Paid Memberships Pro v2.9
Screenshot of the User Fields admin settings page in Paid Memberships Pro v2.9

Create and Manage Field Groups

  1. Navigate to Memberships > Settings > User Fields in the WordPress admin.
  2. Edit the default field group or create a new field group by clicking the “+ Add Field Group” button.
  3. Click “Save All Changes” to save your progress.

Field Group Settings

  • Group Name: A unique label for your group of fields; visible when the field group is shown.
  • Show fields at checkout: Select whether to include this field group anywhere the Membership Checkout shortcode or block is used (on the Membership Checkout page or other landing pages).
  • Show fields on user profile: Select if this field group is shown on the Frontend User Profile or Edit User page in the WordPress admin. Options include: Yes, No, or Yes (only admins).
  • Description: An optional description of the field group. This text is shown below the Group Name when the field group is shown for users or admins.
  • Restrict Fields for Membership Levels: Select one or more membership levels to show these fields for. If you do not select any membership levels, the field group will show for all members and users, regardless of active membership level.

After configuring group settings, continue with the documentation below to create and manage user fields within the group.

Create and Manage User Fields

User Fields inherit some settings from the group and have some unique settings of their own. You can add the same field (use the same Field Name) to two groups to show it in different groups with different rules.

  1. Navigate to Memberships > Settings > User Fields in the WordPress admin.
  2. Create or edit fields in the default field group or use the documentation above to create a new field group for your user fields.
  3. Click the “+ Add Field” button to insert a new field. Or, toggle to expand an existing field to modify settings.
  4. Click “Save All Changes” to save your progress.

User Field Settings

  • Label: A brief descriptive text label for the field. The field label is visible to users or admins.
  • Name: A unique key that identifies the field. Use a single word with no spaces or replace spaces with underscores. This field does not allow any special characters or hyphens (dashes).
  • Type: Select the field type. Additional field settings appear based on the type of field you choose. Options include:
    • Text
    • Text Area
    • Checkbox
    • Radio
    • Select
    • Multi Select
    • File
    • Number
    • Date
    • Read-Only
    • Hidden
  • Required: Select whether to require this field.
  • Read Only: Select whether this field is a read-only field. For example, consider adding a field with the same name on the membership checkout page, then duplicate the field for the user profile only to make it read-only. This would restrict a member from changing their initial response.
  • Show field on user profile? Select to show this user field on the Frontend User Profile or Edit User page in the WordPress admin. Options include: [Inherit Group Setting], Yes, No, or Yes (only admins).
  • Field Wrapper Class: Use this optional field to assign a custom CSS selector to the field’s wrapping div (e.g. my-field-wrapper-class).
  • Field Element Class: Use this optional field to assign a custom CSS selector to the field HTML element (e.g. my-field-element-class).
  • Hint: Use this optional field to add descriptive text for users or admins submitting the field.

Delete a Field Group

If you no longer want a specific field group, you can delete the entire group and all fields in one step. Note that deleting the group also deletes the group’s fields. This action does not delete user data. This action only removes the group and fields from frontend or admin forms.

  1. Navigate to Memberships > Settings > User Fields in the WordPress admin.
  2. Select the Field Group to be deleted.
  3. Click “Delete Group“.
  4. Confirm the action in the modal window.

If you still want the fields from the group in your site, you have to manually recreate them in another Field Group.

Delete a User Field

If you no longer want a specific user field, you can delete the single field in one step. This action does not delete user data. This action only removes the user field from frontend or admin forms.

  1. Navigate to Memberships > Settings > User Fields in the WordPress admin.
  2. Select the Field Group that your field is nested within.
  3. Select the User Field to be deleted.
  4. Click “Delete Field“.
  5. Confirm the action in the modal window.

Extended Functionality for User Fields

The User Fields page in the WordPress admin has settings for the most common ways a membership site needs to add custom fields to their membership and user data. For more advanced developers familiar custom code, please see our Register Helper Add On documentation.

This Add On has more in-depth field options, including additional field types, more group settings, as well as advanced logic to write a custom save callback function to process or store user data in different ways.