Skip to main content

Groups List

Groups List​

Lists published LifterLMS Groups in a grid of one to six columns. Each card can show the group's banner, logo, title, excerpt, member count, seat count and a button to the group page. You can list every group, only groups with a given visibility (Open, Private or Closed), or only the groups the current visitor belongs to. The widget sits under the Lifter Elements - Groups category of the Elementor panel and works on any page or template.

Requires LifterLMS Groups

This widget is registered only when the LifterLMS Groups add-on is installed and activated alongside Lifter Elements.

Groups List widget rendered as a three-column grid of group cards

Usage​

Public groups directory — Drop the widget on a page and keep Visibility on All Groups, or set it to Open only so visitors only see groups they can join. Pair it with the Group Invitation Link widget on the group page itself so visitors can join once they land there.

"My groups" block on a dashboard — Set Visibility to Enrolled only. Each logged-in student sees only the groups they belong to; a visitor who is not logged in sees the Empty Message instead. Turn Show Seat Count off for this use, since seats matter to leaders rather than members.

Leader overview — Keep Show Member Count and Show Seat Count on so group leaders can see how full each group is at a glance, and link to a group template that uses the Group Members widget for the full roster.

Single-group data — To print one group's name, logo, counts or URL inside your own layout rather than a list, use the Groups dynamic tags.

How it works​

The widget runs a standard WordPress query for published groups, ordered by Order By and Order, and prints one card per result. Visibility either adds a meta filter on the group's visibility setting or, for Enrolled only, restricts the query to the groups the current student is enrolled in (whatever their role in the group).

SituationBehaviour
Visibility is Enrolled only and the visitor is not logged inThe widget prints the Empty Message in a paragraph and nothing else.
Visibility is Enrolled only and the logged-in user belongs to no groupsThe query returns nothing, so the Empty Message is printed.
No group matches the filter (for example no group is set to Closed)The Empty Message is printed.
Visibility is All Groups, Open only, Private only or Closed onlyThe list is the same for every visitor, logged in or not; the visibility setting is used as a filter only, not as an access check. Use Conditional Logic to hide the widget from visitors who should not see it.
Group has no banner or no logoThe banner and logo elements are skipped for that card even when their Show switch is on.
Group has no excerptThe excerpt element is skipped for that card.
Show Member Count and Show Seat Count are both offThe meta block is left out of the card entirely.

Card titles and buttons link to the group's page. Member count is the group's current number of members; seat count prints used and total seats as used / total.

Settings​

Content

SettingDescription
List all resultsYes (default) lists every group that matches the filter. No reveals Number of Groups.
Number of GroupsMaximum number of groups to print, 1 to 100. Default 10. Shown only when List all results is No.
ColumnsCards per row, 1 to 6, per device. Defaults: 3 on desktop, 2 on tablet, 1 on mobile.
Order BySort key: Title (default), Date (publish date), Last Modified, Menu Order or Random.
OrderAscending (default) or Descending.
VisibilityWhich groups to list. All Groups (default) lists every published group. Enrolled only lists the groups the current user belongs to. Open only, Private only and Closed only list groups whose LifterLMS Groups visibility setting matches. See How it works.
Show LogoShow (default) prints the group logo above the title.
Show BannerShow prints the group banner image at the top of the card. Default Hide.
Show TitleShow (default) prints the group title as a link to the group page.
Show ExcerptShow (default) prints the group excerpt.
Show Member CountShow (default) prints Members: followed by the number of members.
Show Seat CountShow (default) prints Seats: followed by the used and total seat numbers, for example 4 / 10.
Show ButtonShow (default) prints a button linking to the group page and reveals Button Text.
Button TextLabel of the card button. Default View Group. Shown only when Show Button is Show.
Empty MessageText printed when no groups match. Default No groups found.

Style — Card

SettingDescription
Background ColorBackground of each group card.
Border / Border Radius / Box ShadowElementor's border, corner-rounding and shadow controls for the card.
PaddingInner spacing of the card, in px, em or %.
Gap Between CardsSpace between cards in the grid, 0 to 60 px. Default 20.

Style — Logo (shown only when Show Logo is Show)

SettingDescription
HeightHeight of the logo image, 20 to 300 px.
Object FitHow the logo scales inside that height: Default, Contain, Cover or Fill.
AlignmentLeft, Center or Right.

Style — Title (shown only when Show Title is Show)

SettingDescription
TypographyFont settings for the title.
Color / Hover ColorTitle link colour in its normal and hovered states.

Style — Excerpt (shown only when Show Excerpt is Show)

SettingDescription
Typography / ColorFont settings and text colour of the excerpt.

Style — Meta (shown only when Show Member Count or Show Seat Count is Show)

SettingDescription
Label Typography / Label ColorFont settings and colour of the Members: and Seats: labels.
Value Typography / Value ColorFont settings and colour of the numbers that follow them.

Style — Button

SettingDescription
TypographyFont settings for the button label.
Normal / HoverText Color and Background Color for each state of the button.
Border / Border Radius / PaddingBorder, corner rounding and inner spacing of the button.

Advanced

The Advanced tab holds Elementor's own layout, motion, responsive and custom-CSS controls — see Elementor's documentation. Lifter Elements adds one section, Conditional Logic, which shows or hides this widget by the visitor's LifterLMS status — see the Conditional Logic reference.

Notes​