Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -613,6 +613,7 @@
"workspaces",
"invite-collaborators",
"manage-members",
"user-groups",
"granular-permissions",
"comment"
]
Expand Down
53 changes: 53 additions & 0 deletions user-groups.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: "User Groups"
description: "Create groups to manage workspace and form access for multiple team members at once."
sidebarTitle: "User Groups"
icon: "users"
---

User Groups let admins bundle team members together and grant them workspace or form access all at once. Instead of assigning permissions to each member individually, you can manage access for an entire group in one place.

<Warning>
User Groups are available on the **Team** and **Enterprise** plans. Learn more about the [Team plan](/team-plan).
</Warning>

## Create a group

<Steps>
<Step title="Open group settings">
From your dashboard, click your `Account name` in the upper left corner and select `Settings`. Then, switch to the **Groups** tab.
</Step>
<Step title="Create a new group">
Click `+ New group` and give the group a name.
</Step>
<Step title="Add members & change permissions">
Using the dropdown menu on a group you can manage members or change the permissions of this group.
</Step>
</Steps>

## Assign permissions to a group

Groups can have **Use** or **Edit** permissions on workspaces or individual forms, apps, or databases within a workspace.

- **Use** – Members can view forms and their results and use apps but aren't able to edit them.
- **Edit** – Members can edit and remove forms, apps, and databases.

If a user has permissions from multiple sources (e.g., directly and via a group), the highest permission always wins. For example, if a group grants **Use** access but the user was individually granted **Edit** access, they'll have **Edit** access.

<Info>
**Use** permissions are currently not implemented on databases. If a user only has **Use** permissions for a database, it will not show up for them.
</Info>

## Related articles

<CardGroup cols={3}>
<Card title="Granular Permissions" icon="universal-access" iconType="regular" color="#FFC738" href="/granular-permissions">
Set member access levels and restrict integration accounts.
</Card>
<Card title="Manage Members" icon="user-gear" iconType="regular" color="#FFC738" href="/manage-members">
Add, remove, and update team members.
</Card>
<Card title="Workspaces" icon="folders" iconType="regular" color="#FFC738" href="/workspaces">
Organize forms in folders and control user access.
</Card>
</CardGroup>