> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uplifter.app/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I split a program's athletes into groups?

> Turn on Participant Groups, add groups with a coach and an optional size, place athletes by hand or with Auto-place, and edit, reorder or delete groups.

> [!NOTE]
>
> **Must know**
>
> * **Needs Participant Groups, and publishing is final.** The **Groups** tab shows only when Participant Groups is in your plan and on at **Settings > Organization > Features**. Families see nothing until you click **Publish groups**, which can't be undone.
> * **Group coaches need the program's certifications.** A coach missing one is refused, or for a governing body's certification you can assign anyway.
> * **Swap names, or names and coaches.** Typing another group's name offers to swap the two, or **Swap name and coach with \[group]** if you picked its coach.
> * **Copies come through Copy season.** Groups come over empty and unpublished when **Program groups** is ticked under **What comes over**.

**Before you start.** The program's **Groups** tab appears only when your club has Participant Groups. If it is in your plan, staff with **Edit settings** can switch it on or off at **Settings > Organization > Features**. If it is not, the row is read-only and names the plans that include it. A row reading "Set by Uplifter" needs Uplifter. You also need **Manage participant groups**.

**1. Open the Groups tab**

Go to **Registrations > Programs**, open the program and select **Groups**.

**2. Add a group**

Click **Add group** and pick the **Coach** first: the **Name** fills in from it. A name is required, up to 100 characters, and unique in the program. **Most athletes (optional)** takes 1 to 9999, or blank for "No limit". Auto-place stops at it. Click **Add group**.

**3. Place athletes by hand**

Click **Select**, tick athletes, pick a group from **Move to group** and click **Move**. Up to 500 move at a time. A full group asks first, and **Move anyway** goes over its size.

**4. Or let Auto-place split them**

Click **Auto-place** (greyed out until there is a group and an athlete holding a place). Choose **Age**, **Level** or **Evenly**. **Age** and **Level** fill the groups in sub-tab order, youngest or lowest first. **Evenly** gives each athlete, in name order, to the group with the fewest so far. Tick **Include athletes already in a group** to re-split everyone (ticked when **Ungrouped** is empty). Click **Preview**, then **Apply** (greyed out when nothing would change). Anyone who does not fit stays in **Ungrouped**.

**5. Publish**

Click **Publish groups** in the "Families cannot see these groups yet" banner. [Publishing groups](https://docs.uplifter.app/club/programs-classes/publish-groups-to-families.md) covers the email.

**Emailing families.** **Email the families about this change** shows when you move athletes into a group (never to **Ungrouped**), and only when the groups are published and the Group Placement email is on in your notification settings. It starts ticked. Auto-place offers the same email under the same rule, worded **Email the families of athletes whose group changes** when you re-split everyone.

**Coach certifications.** A coach new to the program's staff must hold the [certifications the program requires](https://docs.uplifter.app/club/programs-classes/require-certifications-to-coach-a-program.md).

* The **Coach** list marks a coach missing one "\[name] (certification needed)", and a red sentence says what they need.
* Saving is refused with "Staff missing required certifications: \[names]."
* If a governing body's certification is among those missing, the save asks **Assign anyway?**. Click **Assign anyway** and the governing body is told its requirement was set aside. When only your club's own requirements are missing, there is no override.
* Coaches already on the program's staff, two groups trading coaches and **Undo** are not checked.

**Reading the tab.** Sub-tabs show **All**, **Ungrouped** and each group with a count. A group's header reads "Coach: \[name]" or "No coach yet", then "12 of 15 athletes". Each sub-tab lists **Athlete**, **Age** and **Level** (plus **Group** on **All**). Click a name to open that athlete's registration, or use **Search athletes...** to find one. Only athletes holding a place appear.

**Change a group.** Use the actions menu on its sub-tab:

* **Edit group** changes the coach, name or size. A size below the current count moves nobody out.
* Typing another group's name shows **Swap names: the group now called \[group] becomes \[this group]**. It becomes **Swap name and coach with \[group]** if you picked that group's coach.
* On a published group with the Group Placement email on, a new coach offers **Email the families in this group about the new coach**, ticked by default.
* **Move up** and **Move down** set the order Auto-place follows.
* **Delete group** asks first. Its athletes go to **Ungrouped**; attendance and evaluations stay. **Undo** in the toast, for about 10 seconds, restores the group and its athletes still ungrouped.

**Who can do what.** Without **Manage participant groups** the tab is read-only. In the coach portal, **Manage program participants** lets a coach move athletes and add a group by name ([limit a coach to their groups](https://docs.uplifter.app/club/staff-operations/restrict-a-coach-to-their-groups.md)).

**Elsewhere.**

* [Bulk edit](https://docs.uplifter.app/club/programs-classes/bulk-edit-programs.md): **Participant groups** adds a group, sets its coach or renames it across programs, moving nobody.
* **Copy season**, **Copy to season** and **Copy from existing** ([copying a season](https://docs.uplifter.app/club/programs-classes/copy-a-season.md)) carry each group's name, order and size, never its athletes. A coach who can no longer coach is dropped, and copies start unpublished. Copy season needs **Program groups** ticked under **Bring over** (the default), keeps coaches only with **Coaches** ticked, and rolls year and term words in names forward.

**Related:** [Publish groups](https://docs.uplifter.app/club/programs-classes/publish-groups-to-families.md) · [Copy a season](https://docs.uplifter.app/club/programs-classes/copy-a-season.md) · [Require certifications to coach](https://docs.uplifter.app/club/programs-classes/require-certifications-to-coach-a-program.md) · [Move an athlete between groups](https://docs.uplifter.app/coaches/coach-your-day/class-groups-move-athlete.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.