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
, ordisplay_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 otherusermeta
field available in your site. - Membership Information: Details about the active membership, including:
membership_name
,membership_startdate
, andmembership_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 from1
to20
).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 from1
to100
).map_max_zoom
: The maximum zoom level allows for the map. default:NULL
for no limit or restriction (accepts any value from1
to20
).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 from1
to20
). - 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 from1
to100
). - Max Zoom: The maximum zoom level allows for the map. default:
NULL
for no limit or restriction (accepts any value from1
to20
). - 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.
Get Support From Our Team of Experts
For more help with this PMPro feature, check out our Support Page with three ways to get support as a free or premium member.
Last updated on August 20, 2025