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

# Creating a Group

> Bundle members into a Group so you can share apps and Collections with the whole set at once.

<Frame caption="Walkthrough: creating a Group.">
  <iframe src="https://drive.google.com/file/d/1cofP-ZO8klbtXlnJ-P4SGJKBSlembK2J/preview" frameborder="0" allow="autoplay" allowfullscreen="" style={{ width: "100%", maxWidth: "720px", aspectRatio: "16 / 9", margin: "1.5rem auto", display: "block" }} />
</Frame>

A **Group** is a named set of members inside your organization that you can share with all at once. Instead of adding fifteen teachers to an app one at a time, you put them in a Group and share with the Group. Add or remove members later and their access follows automatically. Groups are an org-level container, so you create and manage them from your organization dashboard.

Groups are about **people**; [Collections](/getstarted/Creating%20a%20Collection) are about **apps**. They pair well: share a Collection with a Group to hand a curated set of apps to a whole team in one move.

## Create a Group

<Steps>
  <Step title="Open your organization dashboard" icon="layout-dashboard">
    Groups live at the org level, alongside Workspaces, Apps, Collections, and Members.
  </Step>

  <Step title="Go to the Groups tab" icon="users">
    You'll see existing Groups in your org and a button to make a new one. An org with no Groups yet shows an empty state inviting you to create your first.

    <Frame caption="The Groups tab on your org dashboard. An org with no Groups yet shows this empty state.">
      <img src="https://mintcdn.com/playlabai/N_qf0YRGPeXGUWqu/images/v2/creategroup1.png?fit=max&auto=format&n=N_qf0YRGPeXGUWqu&q=85&s=d9c7ebfdf870aaf96dfeadcb8069befc" alt="The Groups tab of an organization dashboard showing the empty state 'Organize members with groups' with a Create Group button, and an Add Group button in the top right." width="500" className="mx-auto" data-path="images/v2/creategroup1.png" />
    </Frame>
  </Step>

  <Step title="Click Create Group" icon="plus">
    Click **Create Group** in the empty state (or **Add Group** in the top right). Give your Group a clear name that says who's in it — like "9th Grade Science Team," "District Coaches," or "Pilot Cohort."
  </Step>

  <Step title="Add members" icon="user-plus">
    In the **Manage Group Members** dialog, add people two ways: **Search for people** by name, or **Paste a list** of email addresses (comma-, whitespace-, or line-separated). Everyone you add must **already have a Playlab account and belong to your organization** — Groups organize existing org members, they don't invite new people. Click **Add members to group**.

    Current members show in the list below, each with a remove icon. Managing a Group is just adding and removing people here, anytime.

    <Frame caption="The Manage Group Members dialog: search for people or paste a list of org emails, then click Add members to group. Current members appear below, each removable.">
      <img src="https://mintcdn.com/playlabai/N_qf0YRGPeXGUWqu/images/v2/managegroupmembers.png?fit=max&auto=format&n=N_qf0YRGPeXGUWqu&q=85&s=0be012f8ed65c9506d1b4abf78197a6d" alt="The Manage Group Members dialog with Search for people and Paste a list tabs, a Member Emails text area, an Add members to group button, and a list of current members each with a remove icon." width="500" className="mx-auto" data-path="images/v2/managegroupmembers.png" />
    </Frame>
  </Step>

  <Step title="Close when done" icon="check">
    Members are added the moment you click **Add members to group** — there's no separate save. Close the dialog and the Group is ready to use as a recipient anywhere you share.
  </Step>
</Steps>

## Use a Group

Once a Group exists, it works as a single recipient anywhere you'd otherwise add people one at a time.

### Share an app or Collection with the Group

1. Open the app or [Collection](/getstarted/Creating%20a%20Collection) you want to share and click **Share**.
2. In the **Search for user, group, or organization** field, start typing the Group's name and select it. It appears under **Groups** with its own role control.
3. Set the role: **Viewer** lets members use what you shared; **Editor** is for collaborators who build with you.
4. Click **Done**. Every member of the Group gets access at the role you set.

<Frame caption="The Share modal with a Group added as a recipient. Set its role — here Viewer — and every member of the Group gets that access.">
  <img src="https://mintcdn.com/playlabai/LAnMv7XIv6fYKHyM/images/v2/shareapptogroup.png?fit=max&auto=format&n=LAnMv7XIv6fYKHyM&q=85&s=630e49487845ebbbdd897288219e1637" alt="The Share My first app modal with a search field for users, groups, or organizations, a Users section listing one person, and a Groups section listing 'My new group!' set to Viewer, plus a Done button." width="500" className="mx-auto" data-path="images/v2/shareapptogroup.png" />
</Frame>

### Add a whole Group to a workspace

<Warning>
  **Temporarily unavailable.** Adding a Group directly to a workspace is paused while we improve how groups and workspaces work together. In the meantime, place a whole team into a workspace by setting up the **workspaces and groups** on an [organization invitation](/getstarted/Adding%20Members%20to%20your%20Workspace) — new members land in the right workspaces on their first sign-in. Sharing apps and Collections with a Group (above) is unaffected.
</Warning>

When this returns, you'll add a Group to a workspace from the workspace's **Add members** dialog: switch to the **Search organization** tab, start typing the Group's name, and pick it to **bring in all its members at once** — no need to add them one by one.

<Tip>
  Membership changes flow through. Add someone to the Group later and they pick up everything already shared with it; remove them and their access drops. You don't re-share.
</Tip>

For the full sharing walkthrough, including sharing with whole organizations, see [Sharing with groups and orgs](/features/Sharing%20with%20Groups%20and%20Orgs).

## Key points

<Info>
  * A Group is a named, reusable set of members inside your organization
  * Create it from your org dashboard's Groups tab, then add members
  * Share an app or Collection with the Group and every member gets access
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="What's the difference between a Group and a workspace?">
    A workspace is where apps live and where classroom activity happens. A Group is just a named list of people you can share to at once. A Group has no apps or activity of its own.
  </Accordion>

  <Accordion title="Can a member be in more than one Group?">
    Yes. People can belong to any number of Groups. Each Group's shares apply independently.
  </Accordion>

  <Accordion title="Do I have to recreate a Group to change who's in it?">
    No. Open the Group and add or remove members. Anything already shared with the Group updates to match the new membership.
  </Accordion>

  <Accordion title="Can I share a Group with people outside my org?">
    Groups hold members of your own organization. To reach another organization, share with that org directly. See [Sharing with groups and orgs](/features/Sharing%20with%20Groups%20and%20Orgs).
  </Accordion>
</AccordionGroup>

***

Last updated: 06-26-2026

Contact us at [support@playlab.ai](mailto:support@playlab.ai)
