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

# Groups

> Organize workspace members into groups for granular control over project access and published app visibility.

Groups let you organize workspace members into named collections, making it easier to manage access across your workspace. Instead of managing permissions for individual users, you can grant access to an entire group at once.

With groups, you can:

* **Share projects with groups** so that an entire team gets access at once, instead of adding collaborators one by one
* **Share folders with groups** so that all projects inside a folder are accessible to an entire team at once
* **Control who can access published apps** by restricting a published website or internal tool to specific groups instead of the entire workspace
* **Sync groups from your identity provider** so that groups created through [SCIM provisioning](/features/business/scim) appear alongside manually created groups

<Note>
  Groups are available on **Business and Enterprise** plans.
</Note>

## Create and manage groups

Workspace admins and owners can create and manage groups from the workspace settings.

### Create a group

1. Go to **Settings → Groups**
2. Click **Create group**
3. Enter a group name
4. Search for and add members to the group
5. Click **Create group**

### Manage group members

To add or remove members from an existing group:

1. Go to **Settings → Groups**
2. Click a group to open its detail page
3. To add a member, click **Add member** and search for the person you want to add
4. To remove a member, click the menu on a member row and select **Remove**

On the detail page, you can filter the member list by name or email and by group role.

Each group member has a role within the group: **Admin** or **Member**. Group admins can add and remove members from the group. You can change a member's group role from the member menu.

A workspace member can belong to multiple groups. Changes to group membership take effect immediately.

### Delete a group

1. Go to **Settings → Groups**
2. Click a group to open its detail page
3. Click **Delete group**

Deleting a group removes the group and its associated access. It does not remove members from the workspace.

### **Export group membership**

You can download a CSV of group membership. Use this for record-keeping, auditing, or migrating membership data outside Lovable.

1. Go to **Settings → Groups**
2. Click **Export**

The CSV includes one row per group membership, with the following columns:

* Workspace name and ID
* Group name and ID
* User name and ID
* Email
* Date added
* Who added them

## SCIM groups

If your workspace uses [SCIM provisioning](/features/business/scim), groups pushed from your identity provider automatically appear in **Settings → Groups** alongside manually created groups. SCIM-managed groups are marked with a **SCIM** badge and cannot be edited directly in Lovable. Membership for SCIM groups is managed from your identity provider.

Both types of groups work the same way when granting access.

For details on configuring group push and role mappings, see [Set up SCIM user provisioning](/features/business/scim).

## Share projects with groups

Instead of inviting individual collaborators to a project, you can share it with an entire group. This is useful when onboarding a new team to a project or when multiple people across a department need access.

### Add a group to a project

1. Open the project you want to share
2. Click **Share**
3. Search for a group name
4. Select the group and assign a role
5. Click **Share**

All members of the group are granted access to the project with the assigned role. Each group member receives a notification, and the project appears in their **Shared with me** section.

### Remove a group from a project

1. Open the project and click **Share**
2. Find the group in the list of collaborators
3. Click the menu on the group row and select **Remove**

Removing a group revokes access for all members of that group, unless they also have individual access to the project.

### How group and individual access interact

* If a member has both individual access and group access to a project, the **higher permission level** applies.
* Removing a group from a project does not affect members who were also added individually.

## Share folders with groups

On Business and Enterprise plans, you can add groups as collaborators on a folder. All projects inside the folder become accessible to members of that group with the role you assign. This is useful when a team needs access to a collection of related projects without having to be added to each one individually.

### Add a group to a folder

1. Go to your dashboard and find the folder
2. Click the folder menu (**⋯**) and select **Share**
3. Search for a group name
4. Select the group and assign a role
5. Click **Share**

### Remove a group from a folder

1. Click the folder menu (**⋯**) and select **Share**
2. Find the group in the collaborator list
3. Click the menu on the group row and select **Remove**

Removing a group from a folder revokes access to all projects in the folder for members of that group, unless they have individual access to a specific project.

## Publish to specific groups

On Business and Enterprise plans, you can restrict who can access your published app to specific groups or individual users, rather than making it available to the entire workspace.

This is useful when you want to:

* Share internal tools with only the teams that need them
* Restrict access to sensitive dashboards, for example financial reports for leadership only
* Control app visibility across different departments

<Note>
  Project collaborators always retain access to the published app, regardless of the website audience.
</Note>

To publish to specific groups or members:

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

  <Step title="Choose the Custom audience">
    Select the visibility row to open **Who can view your site?**, then select **Custom**.
  </Step>

  <Step title="Open the audience picker">
    Select **View and edit** on the Custom card.
  </Step>

  <Step title="Add groups or members">
    Search for and select the groups or individual members who should have access.
  </Step>

  <Step title="Apply your changes">
    Select **Done** to close the picker, then **Publish** (or **Publish changes** on a published project).
  </Step>
</Steps>

Audience edits don't take effect while you edit. When you select **Publish** (or **Publish changes** on a published project), Lovable updates who has access.

For more information on website access control, including inviting people outside your workspace by email, see [Publish your project](/features/publish#invite-people-outside-your-workspace).

## FAQ

<AccordionGroup>
  <Accordion title="Which plans include groups?">
    Groups are available on **Business and Enterprise** plans.
  </Accordion>

  <Accordion title="Is there a limit to how many groups I can create?">
    There is no limit to the number of groups you can create in a workspace.
  </Accordion>

  <Accordion title="Can a member belong to multiple groups?">
    Yes. A workspace member can be part of multiple groups. When publishing to groups, a member only needs to be in one of the selected groups to have access.
  </Accordion>

  <Accordion title="What is the difference between SCIM groups and manually created groups?">
    SCIM groups are synced from your identity provider and cannot be edited in Lovable. Manually created groups are managed directly in Lovable. Both types appear in **Settings → Groups** and work the same way when granting access. SCIM-managed groups display a **SCIM** badge.
  </Accordion>

  <Accordion title="What happens when I share a project with a group?">
    All members of the group receive access with the role you assign. Each member gets a notification, and the project appears in their **Shared with me** section.
  </Accordion>

  <Accordion title="What happens if a user has both individual and group access to a project?">
    The **higher permission level** applies. For example, if a user has viewer access individually but their group has editor access, they get editor access. Removing the group does not affect their individual access.
  </Accordion>

  <Accordion title="Are group changes tracked in audit logs?">
    Yes. On Enterprise plans, group creation, updates, deletions, and membership changes are recorded in [audit logs](/features/audit-logs).
  </Accordion>

  <Accordion title="Can I share a folder with a group?">
    Yes. On Business and Enterprise plans, you can add groups as collaborators on folders. All projects inside the folder become accessible to members of that group with the role you assign.
  </Accordion>

  <Accordion title="Can I export group membership?">
    Yes. Workspace admins and owners can download a CSV of group membership from **Settings → Groups**. The export includes workspace name and ID, group name and ID, user name and ID, email, date added, and who added them.
  </Accordion>
</AccordionGroup>


## Related topics

- [Workspace admin settings](/features/workspace-admin-settings.md)
- [Set up workspace single sign-on (SSO)](/features/business/sso.md)
- [Set up SCIM user provisioning](/features/business/scim.md)
- [AGENTS](/AGENTS.md)
- [Sync your Lovable project with GitLab](/integrations/gitlab.md)