Overview
When you activate Uncanny Groups for LearnDash, the plugin automatically creates a set of pages on your site — each pre-loaded with the shortcode its feature needs. This article explains what those pages do, how to customize them with shortcode attributes, and how to surface them to Group Leaders through your site menu. Each page can be built with its matching Uncanny Groups block (search the block inserter) or the equivalent shortcode shown below.
Before you start
- You need Administrator access to your WordPress site.
- The plugin must be activated. If the pages below are missing, you can regenerate them (see Regenerating pages below).
- Avoid using
/groups/in any of these page URLs — LearnDash reserves that path and duplicate routes will cause conflicts.
Auto-generated pages
On first activation, the plugin creates the following pages. You can rename them, customize their slugs, and add them to your navigation at any time. Also, while shortcodes are used for auto-generated pages, blocks are available.
| Page | What it does | Shortcode / Block | Default slug |
|---|---|---|---|
| Group Management | Core hub where Group Leaders manage members, seats, keys, and courses | [uo_groups]Course Report | group-management |
| Course Report | Lets leaders view member progress by course | [uo_groups_course_report]Course Report | group-management-report |
| Quiz Report | Lets leaders view quiz results for their members | [uo_groups_quiz_report]Quiz Report | group-quiz-report |
| Buy Courses | Lets users purchase courses and create groups (requires WooCommerce) | [uo_groups_buy_courses]Buy Courses | group-management-buy-courses |
| Manage Assignments | Front-end assignment review and grading for leaders | [uo_groups_assignments]Assignment Management | assignment-management-page |
| Manage Essays | Front-end essay review for leaders | [uo_groups_essays]Essay Management | essay-management-page |
| Manage Learner Progress | View and edit individual learner progress | [uo_groups_manage_progress]Progress Report | group-progress-report |
URL warning: Do not use /groups/ as any part of these page slugs. LearnDash uses this route internally, and duplicating it will break navigation.
Regenerating pages
If a page is accidentally deleted or you need to reassign which page the plugin points to, you have two options:
- Regenerate automatically — go to Uncanny Groups > Settings and use the Regenerate Pages option. The plugin recreates any missing pages with the correct shortcodes.
- Re-select an existing page — if you have already created a replacement page manually, go to Uncanny Groups > Settings and select that page from the appropriate dropdown. The plugin will use your custom page going forward.
Configuring the Group Management page
The Group Management page is the most customizable. Use block settings or shortcode attributes to show or hide specific features for your Group Leaders. All attributes accept “show” or “hide” unless noted otherwise.
Feature visibility settings / attributes
| Setting / Attribute | What it controls | Default |
|---|---|---|
group_name_selector | Group selection dropdown | show |
seats_quantity | Seat count display | show |
add_seats_button | Button to purchase additional seats | show |
add_courses_button | Button to purchase additional courses | show |
add_user_button | Add user options in the Users panel | show |
remove_user_button | Remove user capability | show |
upload_users_button | Bulk user upload option | show |
download_keys_button | Download enrollment keys option | show |
key_column | Enrollment keys column in the user table | show |
key_options | Key distribution options | show |
group_leader_section | Group Leaders listing section | show |
add_group_leader_button | Add Group Leader capability | show |
group_courses_section | Group courses listing section | show |
csv_export_button | CSV export option | show |
excel_export_button | Excel export option | hide |
group_email_button | Email users functionality | hide |
first_last_name_required | Require first and last name in the bulk add tool | no (values: yes / no) |
Pagination settings / attributes
| Setting / Attribute | What it controls | Default |
|---|---|---|
enrolled_users_page_length | Members shown per page (numeric) | 50 |
enrolled_users_length_menu | Page-length dropdown options | 25,50,100,All |
group_leaders_page_length | Leaders shown per page (numeric) | 50 |
group_leaders_length_menu | Leaders page-length dropdown options | 25,50,100,All |
Edit Group Wizard redirect settings / attributes
| Setting / Attribute | What it controls | Example value |
|---|---|---|
edit_page_id | ID of the page containing the Edit Group Wizard | 142 |
edit_url | Relative URL of the page containing the Edit Group Wizard | /edit-group/ |
Use either edit_page_id or edit_url — not both.
Example: hide all optional features
[uo_groups group_name_selector="hide" add_courses_button="hide" seats_quantity="hide" add_seats_button="hide" add_user_button="hide" remove_user_button="hide" upload_users_button="hide" download_keys_button="hide" group_leader_section="hide" add_group_leader_button="hide" key_options="hide" csv_export_button="hide"]To fully lock down the interface, also set all report pages to None in Uncanny Groups > Settings.
Configuring the Course Report page
Control how courses and exports appear in the Course Report. The Course Report can be added via the Course Report block or the following shortcode
[uo_groups_course_report course-order="title" csv_export_button="show"]| Setting / Attribute | Values | Default |
|---|---|---|
course-order | ID, title, date, menu_order | (empty — uses LearnDash default order) |
csv_export_button | show, hide | show |
excel_export_button | show, hide | show |
Configuring the Quiz Report page
Control how quizzes and courses are ordered in the Quiz Report. The Quiz Report can be added via the Quiz Report block or the following shortcode
[uo_groups_quiz_report course-orderby="title" course-order="ASC" quiz-orderby="title" quiz-order="ASC"]| Attribute | Values | Default |
|---|---|---|
course-orderby | ID, title, date, menu_order | title |
course-order | ASC, DESC | ASC |
quiz-orderby | ID, title, date, menu_order | title |
quiz-order | ASC, DESC | ASC |
csv_export_button | show, hide | show |
excel_export_button | show, hide | show |
Adding pages to your site menu
The auto-generated pages are not added to your navigation automatically. To surface them for Group Leaders:
- Go to Appearance > Menus in your WordPress admin.
- Find the Group Management section in the page list on the left, and check the pages you want to add.
- Click Add to Menu, then drag items into the position you want.
- If you have the Nav Menu Roles plugin installed, set the visibility of each item to Group Leader so the links only appear to the right users.
- Click Save Menu.
Note: Without Nav Menu Roles, menu links are visible to all logged-in users — but non-Group Leaders who click through will see a message indicating they don’t have access.
Adding a Group Management button or link
To place a contextual button or link anywhere on your site — visible only to logged-in Group Leaders — use one of these shortcodes:
Button:
[uo_groups_button text="Group Management"]Text link:
[uo_groups_link text="Group Management"]Both shortcodes hide themselves from users who are not Group Leaders. Customize the label with the text attribute.
Controlling the Reports menu
The Course Report, Quiz Report, Manage Progress, Assignments, and Essays entries in the Group Leader navigation are controlled from Uncanny Groups > Settings. To hide any of these from the menu, set the corresponding page to None in Settings.
Related Articles
- Install and Set Up Uncanny Groups — first-time activation and settings
- Using the Group Management Page — a Group Leader’s guide to day-to-day management
- Using Group Reports — understanding course, quiz, and progress reports
- Manage LearnDash Groups as a WordPress Administrator — create groups, manage seats, and handle enrollment
- Front-End Group Creation — let Group Leaders create their own groups from the front end
Hi,
What is the attribute to hide the Assignments and Essay buttons?
Best regards,
Peter
Hi Peter, while it is possible to hide them with attributes (these ones would use assignments_button=”hide” essays_button=”hide”), our recommended approach is that you just remove the selections for those pages in the Groups settings page. When the sections are removed the buttons will be hidden automatically.
Hi,
is there a way to rename the menu items (Course, Quiz, Progress, Assignments, Essays)?
Yes, all strings in the plugin should be translation friendly. For renaming items your easiest option is to use a translation plugin; we typically use and test against Loco Translate.
any plans on a front-end group creation?
It is actually supported; have a look at https://www.uncannyowl.com/knowledge-base/front-end-learndash-group-creation/. If you use that shortcode, just make sure you protect the page to authorized users only.
Hi,
I see the comment that says group leaders can create new groups. I’m wondering if we can give group leaders the ability to divide a set number of seats they purchased (for example 100 seats) and then the group leader can divide those seats into different groups they can manage (a group of 20, a group of thirty, a group of 50, for a total of 100 seats.) and then assign courses from there. Their total number of seats would be limited to the 100 they purchased. I’m thinking of teachers creating classes from the 100 seats they purchased.
Hi Drew,
Your request comes up quite often, but at this time seat pools that span multiple groups are not possible. Now that LearnDash 3.2 supports a group hierarchy we’re reassessing what we can do, but right now we can’t confirm when or if we might add support.
Thank you for the quick response. Yes, it seems like this would be a very useful feature for this plugin. Teachers would need to form groups, but I can image it would be a feature other professionals would need to. Thanks for considering!
Hi!
I would like to know if it is possible to create courses in addition to groups through the frontend?
Sorry Michael, I’m afraid none of our plugins support front end course creation.