# Entity Management

> The Entity Management and Resource Grouping feature in the Customer Portal helps you organize licenses, licensing requests (Enterprise Agreement License contracts), and support tickets. If you manage multiple implementations across internal departments or external organizations, this feature lets you allocate licenses and support cases efficiently to specific entities.

## About Entity Management and Resource Grouping

The Entity Management and Resource Grouping feature in the Customer Portal helps you organize licenses, licensing requests (Enterprise Agreement License contracts), and support tickets. If you manage multiple implementations across internal departments or external organizations, this feature lets you allocate licenses and support cases efficiently to specific entities.

## Key features

### Entity tracking

An entity defines how resources are aligned within your organization—for example, by business unit, department, or external partner. This allows you to categorize and group resources such as licenses, support cases, and other related assets to improve resource allocation, monitoring, and reporting.

#### Resources managed by entities
* Licenses
* License consumption history
* Support cases

### Entity assignment and management

1. **Licensing**:
   * Assign entities during license provisioning.
   * View contract consumption by entity on the licensing page.
   * Update license details to reflect entity assignments.
2. **Support cases**:
   * Support cases automatically inherit the entity from the associated license.
   * Cases can be filtered by entity on the Case List page.

## Access and permissions

If you have the appropriate permissions, you can:

* View all entities associated with your account.
* Add new entities or update existing ones.

### Permissions
* **Customer Portal Admin**: Full access to view, create, edit, and delete entities.
* **Customer Portal Regular User**:
  + (Default) View-only access to assigned entities.
  + Edit permissions allows user to create, edit and delete entities.

## Entity management options

### System-defined entities
* These are pre-defined entities provided by the system. You cannot edit or delete them.

### User-defined entities
* You can manually create entities to better match your organizational structure.
* Add, rename, and delete entities from the dedicated Entity Management page.

## How to use Entity Management

### Accessing Entity Management

Navigate to the **Entity Management** section in the Customer Portal using the **Company** menu.

![entity management](https://dev-assets.cms.uipath.com/assets/images/customer-portal/customer-portal-entity-management-548252-fff60b3a-99319997.webp)

### Managing entities

#### Creating a new entity
1. Click the **Create New Entity** button.
2. Enter a unique name for the entity.

#### Renaming an entity

Select the entity to rename, and update its name. All associated records will reflect the updated name immediately.

#### Deleting an entity

Select **Delete** and confirm the action. All associated records will be unassigned and orphaned.

#### Replacing an entity

Select the entity to replace and choose a replacement from the list. All records will be reassigned to the new entity, and the entity will be removed.

:::note
System-defined entities cannot be edited or deleted.
:::

### Assigning entities

Entities can be assigned to licenses from the **Licensing** page, and at the top of license provisioning for **Enterprise License Agreements,** and are cascaded to support cases.

* **Editing existing licenses**:
  1. Navigate to the **Licenses** page under the **Company** menu.
  2. Access license options for a license using the three dots, then select **Update Entity**.
* **Case management**: Entities are automatically applied to support cases based on the associated license.
* **During license provisioning**
  1. During checkout, select an entity name to assign to any new licenses.
  2. Complete the checkout process.
     :::note
     Applicable for customers with “License Management” for ELA contracts. Updates for new licenses may take a few minutes to reflect in Customer Portal.
     :::

## Page-level filters

Entity-based filtering is available on multiple pages within the portal:

* Licensing page
* Case list page

![page-level filters](https://dev-assets.cms.uipath.com/assets/images/customer-portal/customer-portal-page-level-filters-548258-fdbf75cb-5da0b1c5.webp)

## Audit and security

Data Security: Entity data is securely stored and managed. Access is role-based to prevent unauthorized modifications.