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

# Groups

> Organize workspace members into groups to share projects and restrict published apps to specific teams.

Groups let you organize workspace members into named teams, such as Design, Finance, or Support. Instead of managing access person by person, you grant it to a whole group at once.

<Frame>
  <img src="https://cdn.vibely.sh/doc/v1/workspace-groups-1.webp" alt="Groups" width="1200" height="675" />
</Frame>

With groups, you can:

* **Share a project with a group**, so a whole team gets access in one step.
* **Restrict a published app to specific groups**, so an internal tool or dashboard only opens for the teams that need it.

<Note>
  Groups are available on the **Business** plan.
</Note>

## Create and manage groups

Workspace owners and admins create and manage groups in **Settings → Groups**. A group's own Admins can also manage its members (see [Group roles](#group-roles)). Every member can see the list of groups and how many people are in each.

### Create a group

1. Go to **Settings → Groups**.
2. Type a name in **New group name**.
3. Click **Add group**.

### Manage group members

1. Go to **Settings → Groups** and expand the group.
2. To add someone, use **Add member — search by name or email** and pick a workspace member.
3. To remove someone, click the remove button on their row.

Only workspace members can be added to a group. A person can belong to several groups, and changes take effect immediately.

### Group roles

Each group member has a group role, **Member** or **Admin**.

| Who | What they can do in the group |
| - | - |
| **Workspace owners and admins** | Everything: add and remove anyone, make someone a group Admin or remove one, rename or delete the group. |
| **Group Admins** | Add workspace members to the group as **Member**, and remove Members. |
| **Group Members** | See the group and its members. |

Only workspace owners and admins can make someone a group Admin or remove a group Admin, so a group Admin can't promote themselves or anyone else. Creating, renaming, and deleting groups also stays with workspace owners and admins.

### Rename or delete a group

Use the rename and delete buttons on the group's row. Deleting a group removes it and every project access it granted. It doesn't remove anyone from the workspace.

### Export group membership

Click **Export CSV** on the Groups page to download every group and its members.

## Share projects with groups

Instead of inviting people to a project one at a time, you can give a whole group access.

### Add a group to a project

<Steps>
  <Step title="Open the Share project dialog">
    Open the project and click **Invite** in the editor header. The **Share project** dialog opens.
  </Step>

  <Step title="Pick a group">
    Under **Group access**, choose a group from **Add a group…**.
  </Step>

  <Step title="Choose a role">
    Pick **Admin**, **Editor**, or **Viewer**. Every member of the group gets that role on the project.
  </Step>
</Steps>

Only the **project owner** can grant or remove group access, and only groups from the project's own workspace are offered.

### Remove a group from a project

In **Share project → Group access**, click **Remove group** on the group's row. Members of that group lose access unless they also have access another way.

### How group and individual access interact

If someone has access both individually and through one or more groups, the **highest** role applies. Removing a group never affects people who were also added individually.

## Publish to specific groups

You can restrict a published web app so that only members of chosen groups can open it.

<Steps>
  <Step title="Open the publish dialog">
    Open the project and click **Publish**.
  </Step>

  <Step title="Choose who can access your website">
    Under **Who can access your website?**, select **Specific groups**.
  </Step>

  <Step title="Pick the groups">
    Tick the groups that should have access. You need at least one.
  </Step>

  <Step title="Publish">
    Publish, or publish your changes if the app is already live.
  </Step>
</Steps>

Visitors have to sign in to Vibely, and only members of the selected groups get in. See [Publish your web app](/features/deploy/publish) for the other audience options: **Public**, **Workspace**, and **Private**.

<Tip>
  If the list is empty, you'll see "No groups yet. Create groups in workspace settings to use this option." Create a group in **Settings → Groups** first.
</Tip>

<Frame>
  <img src="https://cdn.vibely.sh/doc/v1/workspace-groups-2.webp" alt="Groups" width="1200" height="675" />
</Frame>

## Groups and SCIM

Groups are managed in Vibely only. Your identity provider can't create or change them over SCIM. SCIM has its own three fixed groups that map to workspace roles. See [SCIM](/features/workspace/scim#groups).

## FAQ

<AccordionGroup>
  <Accordion title="Which plans include groups?">
    The Business plan.
  </Accordion>

  <Accordion title="Who can create and edit groups?">
    Workspace owners and admins create, rename, and delete groups. A group's Admins can add people to that group as Members and remove Members. Every member can see which groups exist.
  </Accordion>

  <Accordion title="Can I add someone from outside the workspace to a group?">
    No. Invite them to the workspace first from **Settings → People**.
  </Accordion>

  <Accordion title="What happens to a group's access if I delete it?">
    Every project access it granted is removed at the same time. Members keep any access they have individually.
  </Accordion>

  <Accordion title="Why can't I add a group to my project?">
    Only the project's owner can grant group access, the workspace must be on Business, and the group must belong to the project's workspace.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="People" icon="users" href="/features/workspace/people">
    Manage workspace members and roles.
  </Card>

  <Card title="Publish your web app" icon="globe" href="/features/deploy/publish">
    Choose who can see a published app.
  </Card>

  <Card title="Collaboration" icon="user-plus" href="/features/collaboration/overview">
    Invite people to a single project.
  </Card>

  <Card title="SCIM" icon="arrows-rotate" href="/features/workspace/scim">
    Provision members from your identity provider.
  </Card>
</CardGroup>


## Related topics

- [Set up SCIM user provisioning](/features/workspace/scim.md)
- [Share a project with internal or external collaborators](/features/collaboration/sharing.md)
- [Set up workspace single sign-on (SSO)](/features/workspace/sso.md)
- [Workspace admin settings](/features/workspace/admin-settings.md)
- [Vibely workspace](/features/workspace/overview.md)


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