User List module

Purpose and when to use

The User List module displays a list of users (e.g. members or all registered users) with optional filtering by role, membership plan, or ACF link. Use it for member directories, team pages, or community lists. You can use loop templates for a quick setup or a custom loop layout with the User Item module for dynamic profile data.

Compatibility and performance notes

• Divi: Current Divi version with Divi Membership 2.0.x or later.
• User Item: Use the User Item module inside a custom loop layout to display each user’s fields (name, avatar, membership, profile link, etc.).
• Pagination: Load more is supported via pagination.

Add to page

1. In the Divi Builder, add a new module and choose User List (under Divi Membership).
2. Under Main Options, choose Loop Style: Loop Templates (pre-built) or Custom Loop Layout (Divi Library layout using User Item).
3. Set No Users Layout (Divi Library) and/or No Users Text for when there are no users.
4. Under Loop Options, set User Role, Display Type (Default / Members / Linked), User Limit, Sort Order, Order, and Show Members Only as needed.
5. Configure Grid Options (columns, gutter) and, for loop templates, Loop Template Options (avatar size, name display, website text).
6. Set Choose how to display load more posts to Pagination (or supported option).
7. Save and test with different filters.

Settings

Setting	Type	Default	Depends On	Notes
Loop Style	select	Loop Templates / Custom Loop Layout	—	Pre-built templates or library layout with User Item.
No Users Layout	library	—	—	Layout when no users match.
No Users Text	text	—	—	Message when no users to display.
User Role	select	—	—	Filter by WordPress role (e.g. subscriber).
Display Type	select	Default / Members / Linked	—	All users, only members of a plan, or linked via ACF.
Member Plans	select	—	Display Type: Members	Which plan(s) for members filter.
Linked ACF Name	text	—	Display Type: Linked	ACF field for linked users.
User Limit	number	—	—	Max users to display.
Specific Users	text	—	—	Comma-separated user IDs to include.
Exclude Users	text	—	—	Comma-separated user IDs to exclude.
Include ACF Field & Value	text	—	—	Filter by ACF field value.
Sort Order	select	—	—	Sort by user meta field.
Order	select	ASC / DESC	—	Ascending or descending.
Show Members Only	boolean	—	—	Restrict to users with a membership plan.
Load more style	select	Pagination	—	How to load more (e.g. pagination).
Columns	number	—	—	Grid columns per device.
Custom Gutter Gaps	number	—	—	Spacing between rows/columns.
Avatar Size / Name Display / Website Text	various	—	Loop Templates	Template-specific options.

Examples and common patterns

• Member directory: Display Type = Members, select plan(s), use Custom Loop Layout with User Item for name, avatar, profile link, membership.
• Team page: Use Specific Users or role filter; custom layout with User Item for title, bio, photo.

Pitfalls and limits

• Privacy: Only display user data that complies with your privacy policy and user agreements.
• Performance: Large user limits can slow the page; use pagination and reasonable limits.

Related links

• User Item — Display individual user profile data in the loop.
• Register module — Controls default user role for new registrations.

What's Next

• User Item — Configure which user data to show in each list item.
• Member management — Bulk Assign and member management.
• Feature Overview — Account and modules.