The Member Profile can be customized by changing attributes of the Shortcode or adjusting the settings of the Member Profile Block.

Shortcode and Block

Using the [pmpro_member_profile] Shortcode

Navigate to the WordPress page for your Member Profile and click through to edit the page in the WordPress admin.

If you generated the Member Profile page, it will automatically include the following shortcode: [pmpro_member_profile]. Shortcode attributes include:

elements Attribute

The elements attribute controls what information is shown in the Member Profile and the order the information is displayed.

This attribute accepts a list of label names (optional) and values in the format label,name; (e.g., elements="avatar|256;display_name;Company,company;Website,user_url".)

Supported values for the elements attribute include:

  • User Information: The user object data (stored in the WordPress Users table), including: user_login, user_email, user_url, user_registered, or display_name.
  • User Meta Information: The user meta data (stored in the WordPress Usermeta table). Use the name value of any custom User Field you’ve created or of any other usermeta field available in your site.
  • Membership Information: Details about the active membership, including: membership_name, membership_startdate, and membership_enddate.
  • Address Information: If you are using the Mailing Address Add On, you can display the member’s address using the field ID pmpro_mailing_address. If you want to add individual fields from the mailing address, you can use:
    • pmpro_sfirstname
    • pmpro_slastname
    • pmpro_saddress1
    • pmpro_scity
    • pmpro_sstate
    • pmpro_scountry
    • pmpro_szipcode
    • pmpro_sphone
  • Avatar: Show the member’s avatar and customize the size shown. e.g., elements="Profile Picture,avatar|256".

levels Attribute

The level ID or a comma-separated list of level IDs that support a Member Profile page. The member must have the specific level ID(s) to have their Member Profile displayed, otherwise the page will redirect back to the Member Directory page.

The order attribute sorts the results based on the order_by attribute in ascending or descending order. default: ASC (accepts DESC or ASC).

show_map Attribute

A boolean value of whether or not to show the map. defaults: true if the site has defined a Google Maps API Key within Advanced Settings.

If the map is displayed, the following additional shortcode attributes are available to style the map:

  • map_zoom: The default starting zoom value. default: 8 (accepts any value from 1 to 20).
  • map_height: The map’s height in pixels. default: 400 (accepts any integer).
  • map_width: The map’s percentage width of the page. default: 100 (accepts any value from 1 to 100).
  • map_max_zoom: The maximum zoom level allows for the map. default: NULL for no limit or restriction (accepts any value from 1 to 20).
  • map_infowindow_width: The width of the marker infowindow in pixels. default: 300 (accepts any integer).

show_search Attribute

Optionally hide the search form from the Profile. (e.g., show_search="false").

user_id Attribute

Optionally show a specific user’s profile. This attribute is only necessary if you are building each member’s profile individually. (e.g., user_id="31").

Using the Member Profile Block

Select the Member Profile Block to see block options, including:

Display Options

  • Show Search: Displays a search form that searches on member display name or email address if checked.
  • Show Avatar: Displays the user’s avatar generated via Gravatar or user-submitted using a plugin like Basic User Avatars if checked.
  • Avatar Size: The square pixel dimensions of the avatar to display. default: ‘128’ (accepts any numerical value).
  • Show Bio: Displays the user’s biographical information if checked.
  • Show Level: Displays the user’s membership level if checked.
  • Show Email Address: Displays the user’s email address if checked.
  • Show Name: Displays the user’s display name if checked.
  • Show Start Date: Displays the user’s membership start date for their current level if checked.
  • User ID: Optional field to show a specific user’s profile for this block. If the User ID is not set, the profile will attempt to load the correct user based on the URL structure.

Map Options

Check the box next to “Show Map” to display a map of members in your directory. The map will only display if you have defined a Google Maps API Key within Advanced Settings.

  • Map Zoom: The default starting zoom value. default: 8 (accepts any value from 1 to 20).
  • Map Height: The map’s height in pixels. default: 400 (accepts any integer).
  • Map Width: The map’s percentage width of the page. default: 100 (accepts any value from 1 to 100).
  • Max Zoom: The maximum zoom level allows for the map. default: NULL for no limit or restriction (accepts any value from 1 to 20).
  • Infowindow Width: The width of the marker infowindow in pixels. default: 300 (accepts any integer).

Extra Fields

Use this textarea to display additional user meta fields. The field accepts a list of label names and field IDs, one per line. For example:

Company,company
Website,user_url

Customizations, Theme Compatibility, and Styling

If the shortcode, block, and available hooks and filters do not offer the level of customization you require, refer to this guide on How to Load a Custom Template for Your Member Directory and Profiles.

File-Type Profile Fields

If you are displaying a field that is a file type (audio, video, image, document), the shortcode will attempt to embed or display the file based on the mime type (about WordPress filetypes).

  • Audio files will embed using the WordPress [audio] shortcode
  • Document files will display the appropriate wp_mime_type_icon and a link to view or download the file
  • Image files will display as a standard image on the page at full size
  • Video files will embed using the WordPress [video] shortcode

Third-Party Embeddable Links

If your members have a profile field that links to a third-party embeddable platform like YouTube, Vimeo, and others, the field will also display as an embed. See a list of supported oembed sites here.

Last updated on August 20, 2025


Was this article helpful?
YesNo