Display a Member List Using the [suremembers_list_members] Shortcode

SureMembers lets you display the members of any Membership directly on a page or post using the [suremembers_list_members] shortcode. Whether you’re building a club roster, a student directory, a team page, or a private community listing, this shortcode makes it easy to show your members without any custom code.

Before You Begin

• You need at least one Membership set up in SureMembers with active members.
• The page or area where you add the shortcode must support shortcodes.

Steps

1. Go to SureMembers > Memberships.
2. Find the Membership whose members you want to display. The Membership ID is shown just below the Membership name directly in the list. No need to open the Membership.

3. Go to the page or post where you want to display the member list.
4. Add the shortcode to the content area: [suremembers_list_members membership_id="123"] Replace 123 with the actual Membership ID you noted in Step 2.

5. Click Publish or Update.

What You’ll See

Once the page is live, visitors will see a list showing each member’s profile picture, name, and email address. The layout automatically picks up your theme’s fonts and colors, so it fits right into your existing site design.

Shortcode Parameters

You can customize what the member list shows by adding extra parameters to the shortcode. All parameters are optional except membership_id.

Parameter	Default	What It Does
membership_id	Required	The ID of the Membership to display.
limit	0	Number of members shown per page. 0 shows all members on one page.
layout	grid	Choose between grid or list layout.
show_avatar	true	Shows or hides member profile pictures.
show_email	true	Shows or hides member email addresses.
show_joined	false	Shows the date each member joined.
show_expiry	false	Shows membership expiration dates. Members without an expiry date display “Lifetime”.

For true or false settings, you can also use yes/no or 1/0.

Shortcode Examples

Basic member grid (default)

Displays all members in a card grid layout.

[suremembers_list_members membership_id="123"]

List layout without emails

Useful for a cleaner, more private display.

[suremembers_list_members membership_id="123" layout="list" show_email="false"]

Full member details

Shows email, join date, and expiry date.

[suremembers_list_members membership_id="123" layout="list" show_joined="true" show_expiry="true"]

Paginated grid (20 members per page)

Great for large groups. Pagination links appear automatically below the list.

[suremembers_list_members membership_id="123" limit="20"]

Layout Options

Grid layout displays members as responsive cards arranged in rows. This works well for team pages, visual directories, and community showcases.

List layout displays members as compact horizontal rows. This works well for information-dense listings, student directories, and admin views.

A Few Things to Know

• Only active members are shown. Revoked or expired memberships do not appear in the list.
• Avatars come from WordPress profile pictures or Gravatar. If no avatar is set, a colored circle with the member’s first initial is shown instead.
• Dates follow your site’s date format and timezone, which you can check under WordPress > Settings > General.
• Email addresses are visible to anyone who can access the page. If you want to keep emails private, use show_email="false" or restrict the page using SureMembers access rules.
• Multiple paginated lists on the same page will share the same pagination state. For best results, use only one paginated member list per page.
• Multiple Membships can be displayed on the same page by adding one shortcode per group.

Customizing the Appearance

The member list uses your theme’s fonts and colors by default. If you want to go further, you can add custom CSS under Appearance > Customize > Additional CSS using these classes:

CSS Class	What It Targets
suremembers-member-list	The main container
suremembers-member-list--grid	Grid layout wrapper
suremembers-member-list--list	List layout wrapper
suremembers-member-list__item	Individual member card or row
suremembers-member-list__avatar	The member’s avatar
suremembers-member-list__name	Member’s display name
suremembers-member-list__email	Member’s email address
suremembers-member-list__meta	Join date and expiry details
suremembers-member-list__pagination	Pagination navigation

That’s everything you need to start displaying your members on any page. With a few parameters, you can control exactly what information shows up and how it looks.

If you have any questions or need further help, feel free to reach out to our support team. We’re always happy to help!