# Group

Groups serve as a central hub for organizing and managing teams of users within your system. Similar to departments within an organization, groups bring together users with shared roles and responsibilities. This feature allows you to efficiently organize users, assign permissions collectively, and maintain a well-structured access management framework.&#x20;

Accessing Groups in the Admin Console

To view and manage groups:

1. Open the **Admin Console**.
2. Navigate to the **Groups & Permissions** section.
3. Click on the **Groups** tab in the left-hand menu.
4. A card-based view of the Groups will be displayed.

Searching for Groups

To filter and locate specific groups:

1. Use the **Select Group Category** dropdown menu to filter groups by their associated category.
2. Choose the desired Group Category from the available options to display relevant groups.

This streamlined process makes managing and locating groups efficient and organized.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2Fl1z5mnMciyg8L0KdDC7w%2FG%201.png?alt=media&#x26;token=e713bce1-9719-47b5-965d-c032dcf8fbb4" alt=""><figcaption></figcaption></figure>

### Creating a Group

To create a new group:

1. Click the **Create Group** button.&#x20;

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2F9oBxabsG9QHQnrgAoNW5%2FG%202.png?alt=media&#x26;token=e79d972b-e04f-43c5-9c76-497a09933037" alt=""><figcaption></figcaption></figure>

2. Fill in the required fields as described below:

### <mark style="color:blue;">Group Details</mark>

***Select Group Category:***&#x20;

Assign the new group to a broader category. Categories must be predefined on the **Group Category** page.

***Parent Group:***&#x20;

Use this field to create a subgroup under an existing group. If left blank, the group will be created as a primary group.&#x20;

***Group ID:***&#x20;

A unique identifier for the group to ensure distinction within the system.

***Group Name:***&#x20;

A human-readable label that clearly identifies the group.

***Description:***

Add context about the group's purpose, role, and responsibilities.

***Group Tag(s) (optional):***&#x20;

Assign keywords or tags to the group to help with categorization and search.

* Tags can represent specific attributes or functions of the group.
* Multiple tags can be added by separating them with commas.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FvpO09To2z6wB4Uzpskxt%2FG%203.png?alt=media&#x26;token=8c9b8b89-4c61-49e2-a4b7-a172e72aa41a" alt=""><figcaption></figcaption></figure>

3. Once all mandatory fields are completed, click the **Save** button to create the new group.

The group will be added to the system and ready for further configuration or assignment.

### Editing a Group&#x20;

To edit an existing group:

1. Open the **Admin Console**.
2. Navigate to the **Groups & Permissions** section.
3. Click on the **Groups** tab in the left-hand menu.
4. A card-based view of the groups will be displayed.
5. Locate the group you want to edit and click the **Edit** icon on its card.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FUBiK6SFA82HXnvJo8nfc%2FG%204.png?alt=media&#x26;token=95f62175-181f-4369-957a-d3fda39d9e7a" alt=""><figcaption></figcaption></figure>

6. This will open the **Edit Group** page.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2Fipj3qvUFZEgdiYbf3Ffu%2FG%205.png?alt=media&#x26;token=f2852ea3-1395-4958-92de-59f8ae0c87be" alt=""><figcaption></figcaption></figure>

7. Modify the necessary details, including:

* **Group Category**
* **Group ID**
* **Group Name**
* **Description**
* **Group Tags** (optional)

8. Ensure all mandatory fields are completed or updated as needed.
9. Click the **Save** button to apply and save the changes.

The updated group will be saved and reflect immediately in the system.

### Managing Allowed Permissions

In the **Edit Group** interface, you will find a dedicated section for managing permissions.

* Use this section to review the list of available permissions.&#x20;
* Toggle permissions **on** or **off** to align with the team's responsibilities and access requirements.

This feature allows you to customize the group's permissions, ensuring they have access to the necessary functionalities while maintaining system security.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FM3sQrj7pgPX82t1FBqnb%2FG%206.png?alt=media&#x26;token=fce90cdd-1aca-46db-9929-9421471d4e78" alt=""><figcaption></figcaption></figure>

After selecting the appropriate roles, click the **Save** button to apply and save the Permission Settings.

### Managing Allowed Roles

In the **Edit Group** interface, there is a dedicated section for managing roles.

* Review the list of available roles in this section.
* Select the roles that are applicable to the group. These roles define the overall access and privileges for users within the group.
* After selecting the appropriate roles, click the **Save** button to apply and save the role settings.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FAChjFYEIb6hj8eDII5Kk%2FG%207.png?alt=media&#x26;token=be78359e-a01a-4980-9766-40fbf71eaf64" alt=""><figcaption></figcaption></figure>

This ensures that users in the group inherit the selected roles, aligning their access with the group's responsibilities.

### Delete Group&#x20;

1. In the Admin Console, navigate to the **Groups & Permissions** section.
2. Click on the **Groups** tab on the left.
3. You'll see a card-based view of the Groups.
4. Find the Group you want to delete and click on its card edit icon.
5. This will open the Edit Group Page.
6. On the same Edit Group Page, look for the option to delete the Group.
7. This is often represented by a **Delete** button.
8. Confirm your decision to delete the Group.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FACMDL8bERQx2f7RxB4jC%2FG%208.png?alt=media&#x26;token=6bc35311-ce20-41fa-9269-51370cff3023" alt=""><figcaption></figcaption></figure>
