*** Understanding user groups User groups provide flexible ways to organize your organization members for collaboration, access control, and workflow management. Create and manage groups directly in Ravenna. Add any organization member to a group regardless of their workspace membership. Use manual groups for project teams, departments, or any custom organizational structure. Automatically sync groups from identity providers like Google Workspace. Synced groups maintain their membership from the external system, keeping your Ravenna groups up to date with your organization’s identity provider. Synced groups appear alongside manual groups in the Groups UI. *** Create user groups Go to **Members** in your workspace sidebar navigation, then click the **Groups** tab. Click **+ Group** to open the group creation dialog. Provide a **Name** for your user group (required) and add an optional **Description** to clarify the group’s purpose. Click **Save** to create the user group. User group names must be unique within your organization. You can edit the name and description later. *** Edit a group Edit a group’s name, description, and membership directly on the group details page. Changes save automatically when you confirm each field, so you do not need to open a separate edit dialog. Go to **Members** → **Groups** in your workspace, then click the group you want to edit to open its details page. Click the **Name** or **Description** field to edit it inline. Press **Enter** or click outside the field to save, or press **Escape** to discard your changes. Add or remove members from the **Members** section. You can add users from across your organization, not just workspace members. Membership changes save automatically. Synced groups are read-only in Ravenna. To change a synced group’s name or membership, update it in the source identity provider. *** Synced groups Sync groups automatically from identity providers to maintain consistent group membership across your organization and Ravenna. How group syncing works When you connect an identity provider integration like Google Workspace, Ravenna automatically syncs groups from the external system. Groups are created in Ravenna with matching names and membership is kept in sync. Group membership is synchronized from the identity provider. When users are added or removed from groups in your identity provider, those changes automatically reflect in Ravenna. Synced groups appear alongside manually created groups in the Groups UI. You can use synced groups for access control, workflow assignments, and collaboration just like manual groups. Synced groups show their source integration, making it clear which groups are managed externally versus manually in Ravenna. Supported identity providers Sync Google Workspace groups automatically when you connect the Google Workspace integration. All groups from your Google Workspace organization are synced and kept up to date. Learn how to set up [Google Workspace integration](/integrations/google-workspace/overview) Sync Okta groups automatically when you connect the Okta integration. All groups from your Okta organization are synced and kept up to date. Learn how to set up [Okta integration](/integrations/okta/overview) Sync Slack user groups automatically when you connect the Slack integration. User groups are synced during the initial OAuth authentication and kept up to date. Learn how to set up [Slack integration](/integrations/slack/setup) Managing synced groups Synced group membership is managed in your identity provider. Changes made there automatically sync to Ravenna. You cannot manually edit membership for synced groups in Ravenna. **What you can do with synced groups:** * Use them in access levels for automated provisioning * Assign them as approvers in workflows and ticket approval rounds * Reference them in custom fields and forms * View their membership in Ravenna **What gets synced:** * Group name * Group membership (users in the group) * Membership changes (additions and removals) *** Using groups User groups enable consistent access management and collaboration across your organization. Map groups to access levels in applications for automated provisioning. When users gain access to an application at a specific level, they’re automatically added to the corresponding group in your identity provider. Learn about [application access levels](/documentation/manage-access/applications#access-levels) Use groups as approvers in workflows and ticket approval rounds. Assign approval tasks to entire groups instead of individual users, enabling flexible approval processes. When user groups are selected as approvers for ticket approval rounds, they are automatically expanded into individual users server-side when saved. Reference groups in custom fields like user group select fields on forms and tickets. You can configure an allowlist on user group select fields to restrict which groups appear as options. Use groups to control who can see and submit specific forms. When a form’s audience is set to “User Groups”, only members of the selected groups can access that form in the customer portal, Slack, and ticket creation flows. Learn more about [form audience settings](/documentation/tickets/forms/overview#audience-settings)

Documentation Index