learndash/list-group-members lists the learners who belong to a group.
Membership is what makes a group’s courses reachable, so these are the people any change to the group affects.
At a glance
| Ability | learndash/list-group-members |
| Toolset | LearnDash — toolset/learndash |
| Group | LearnDash › Groups |
| Requires | AcrossAI Pro, plus LearnDash LMS active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
That framing is the useful one. A group change is never about the group — it is about the people whose access depends on it, and this listing is that set.
Removing a course from a group revokes it from everybody here, unless they also hold it directly. Deleting the group revokes everything it carried, from everybody here.
So this is the call before learndash/manage-group-courses or learndash/delete-group, in the same way a step listing precedes a course deletion.
Leaders are separate — learndash/list-group-leaders lists the people who manage the group, who do not necessarily have its course access.
Progress is never affected by membership changes. A learner removed and re-added returns to where they were.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
group_id | integer | Yes | The group. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
members | array | The learners in the group. |
total | integer | How many. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Who is in this group?
It resolves to one call:
{
"ability": "learndash/list-group-members",
"parameters": {
"group_id": 700
}
}Worth knowing
- These are the people a group change affects.
- A member who also holds a course directly keeps it when the group stops granting it.
- Leaders are a separate list and may have no course access.
- Progress survives membership changes.
Related abilities
- LearnDash Manage Group Membership — change who is in it
- LearnDash List Group Leaders — who manages it
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category