# Group Category

Group Category: Organizing Groups for Better Access Management

Group Categories provide a structured way to organize related groups under distinct labels. This feature improves the clarity and efficiency of access management, particularly when managing diverse teams and roles.

Accessing Group Categories in the Admin Console

To view and manage Group Categories:

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

Searching for Group Categories

To locate specific Group Categories:

1. Use the **Search** box located above the Group Category cards.
2. Enter a relevant keyword.
3. Click the **Search** button to display Group Categories that match your keyword.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FuoQijcBKX6O9vpndjnev%2FGC%201.png?alt=media&#x26;token=dbdf0936-13e2-47c5-a5df-782f88cca31a" alt=""><figcaption></figcaption></figure>

#### Creating a Group Category

#### To create a new Group Category&#x20;

1. Click the **Create Category** button.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FBhS9o8S3spncB4tx0snM%2FGC%202.png?alt=media&#x26;token=e3df51fe-5066-44f0-9794-f88d6147ad7c" alt=""><figcaption></figcaption></figure>

2. Fill in the required details as described below.

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

***Category ID:***

A unique identifier for the group category. This ID acts as a special code, ensuring that each category is distinct and easily recognizable.&#x20;

***Category Name:***&#x20;

A human-readable label for the category, making it simple to identify and manage.

***Category Description:***&#x20;

A brief explanation of the category's purpose and scope, providing additional context for its use.

***Metadata Fields***: ***(Optional)***&#x20;

Metadata allows you to attach extra information to a category in the form of **Key-Value pairs**.

***Key:*** Represents the name of the metadata field.

***Value:*** Specifies the associated data or functionality for the key.

&#x20;Use metadata to add flexibility and extended functionality to your categories.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FHn1FgKpYfKXiQWUrR94F%2FGC%203.png?alt=media&#x26;token=9a44d124-97bf-45f5-8fad-6cd7cb174c57" alt=""><figcaption></figcaption></figure>

3. After completing all mandatory fields, click the **Save** button to create the new Group Category.

The new category will be added to the system and ready for use in organizing groups.&#x20;

#### Editing a Group Category

To edit an existing Group Category:

1. Open the **Admin Console**.
2. Navigate to the **Groups & Permissions** section.
3. Select the **Group Category** tab from the left-hand menu.
4. Locate the category you want to edit in the table view.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2Ff7W9wzfIuZQQclbGUdvU%2FGC%204.png?alt=media&#x26;token=28480a3d-b048-47cc-b781-b690c9dbb37c" alt=""><figcaption></figcaption></figure>

5. Click the **Edit** icon on the card to open the **Edit Category** modal.
6. Make the necessary changes to the following fields:

* **Category ID**
* **Category Name**
* **Category Description**
* **Metadata Fields** (optional)

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FM26AjUZtyRKfFl3XUqlk%2FGC%205.png?alt=media&#x26;token=99a57c83-46a8-4667-8c25-78eeb87589d5" alt=""><figcaption></figcaption></figure>

7. Ensure all mandatory fields are filled out.
8. Click the **Save** button to apply and save the changes.

The updated category will reflect immediately in the system.

### Deleting a Group Category

To delete a Group Category:

1. Open the **Admin Console**.
2. Navigate to the **Groups & Permissions** section.
3. Select the **Group Category** tab from the left-hand menu.
4. Locate the category you wish to delete in the card view.
5. Click the **Edit** icon on the card to open the **Edit Category** modal.
6. In the modal, locate and click the **Delete** button.
7. A confirmation prompt will appear. Review the details carefully, and confirm your decision to delete the category.

Once confirmed, the category will be permanently removed from the system.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FuJ5lneap5RxfoGORttMk%2FGC%206.png?alt=media&#x26;token=6c0dc7d7-0891-48e0-b0ef-ab2fdde1a950" alt=""><figcaption></figcaption></figure>
