# Managing Groups ## Custom Groups Groups in SeaLights allow you to organize users and manage their access to specific applications they interact with. Users possessing the "Manage Users & Permissions" permission can create, update, or delete these groups to align with your organizational structure, such as departments or teams. ### Creating a Group 1. In the `Groups` section under `Users & Permissions` , click `Create Group` . 2. Provide a name and an optional description for the group. 3. Assign applications to the group. 4. Click `Create` . 5. Optionally, add existing users as members. 1. When members are added to a group, they'll receive an email notification informing them of their new group assignment. ### Updating a Group 1. In the `Groups` list, find the group using the search bar or by navigating the list. 2. Click on the group's entry. 3. You can update the group's name, description, assigned applications, and members. ### Deleting a Group To delete a group, you'll first need to deactivate it: 1. In the `Groups` list, locate the group you want to delete. 2. Hover over the group and click the deactivate switch button. 3. Confirm the action when prompted.\ (As long as the group is only deactivated and not deleted, you can reactivate it if needed). 4. Once deactivated, hover over the group again and click the `Delete` icon. 5. Confirm the deletion when prompted. *** ## System Groups SeaLights includes special, default system groups: **Everyone** and **Unassigned Users**. Users with "Manage Users & Permissions" can update these groups. ### Group: Everyone This group automatically includes **all users** in your organization, regardless of whether they have been assigned to other custom groups. * **Purpose:** To easily grant a common set of applications to all users in your organization. * **Key Behavior:** Applications assigned to this group are visible to every user. * **Use Cases:** * If you have a core set of applications that everyone should always have access to, regardless of their team or role. * If you choose *not* to manage application access via custom groups, you can **enable** the "Assign all apps to this group" flag within the **Everyone** group. This will make all existing and future applications visible to all users by default, simplifying access management in broader scenarios. * **"Assign all apps to this group" flag:** This flag is **off by default**. * **To set the "Assign all apps to this group" flag:** 1. Go to `Settings` > `Users & Permissions` > `Groups` 2. Locate and click on the **Everyone** Group. 3. Toggle the **"Assign all apps to this group"** flag.
### Group: Unassigned Users This group automatically contains all users in your organization who **have not been explicitly assigned to any other custom group**. * **Purpose:** Primarily to manage the initial application visibility for new users who haven't yet been placed into a specific team or departmental group. * **Key Behavior:** Applications assigned to this group are visible only to users who are *not* part of any other group. * **Use Cases:** * To ensure that newly onboarded users can immediately see and interact with all applications upon their first login, even before they are assigned to a specific team's group. * If you prefer to restrict or specify the applications new, unassigned users can see, you can **toggle this flag off** or assign only a limited set of specific applications to this group. * **"Assign all apps to this group" flag:** This flag is **on by default**. * **To set the "Assign all apps to this group" flag:** 1. Go to `Settings` > `Users & Permissions` > `Groups` 2. Locate and click on the **Unassigned Users** Group. 3. Toggle the **"Assign all apps to this group"** flag. ### Key Differences at a Glance: | Feature | Everyone Group | Unassigned Users Group | | ---------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------- | | **Membership** | All users in the organization | Users *not* assigned to any other custom group | | **Primary Use** | Broad access for all users | Initial access for new/unassigned users | | **Default "Assign all apps" Flag** | **Off** | **On** | | **Application Visibility** | Apps assigned here are seen by *everyone* in the organization. | Apps assigned here are seen *only* by users *not* in any other group. | *** ## Unassigned Applications Applications that are not assigned to any group in your organization are considered **unassigned applications**. By default, these applications are not visible to any user in SeaLights unless the "Assign all apps to this group" toggle is enabled in one of your system groups (like the "Everyone" group or "Unassigned Users Group"). Applications can become unassigned in two main scenarios: * A brand new application is reported to SeaLights through your Continuous Integration (CI) process and hasn't yet been assigned to a group. * An application was previously assigned to one or more groups but has since been removed from all of them. Users with the **"Assign Unassigned Apps"** permission have the ability to assign these applications to existing groups, making them visible to relevant users. #### How to Assign Unassigned Applications 1. Go to `Settings` > `Users & Permissions` > `Unassigned Apps` 2. Find the applications you want to assign by browsing the list or using the search bar. 3. Select the desired applications. 4. Click on **Assign To Group(s)**. 5. Choose the groups you want to assign the applications to from the list. 6. Click **Assign to Groups** to complete the process.