# Account Roles

The Account Roles tab, located under Settings for customers, allows you to create and manage one or more roles for your customer account system. These roles work in conjunction with customer entities to provide structured permission and access management.

## Overview

![Account roles view](/assets/account-roles.eaa536e606f7382298ab1cd65dd5bfeb51555c1d8220b4bb9704a648cbd0c152.17d27d97.png)

Account roles serve as the foundation for organizing customer permissions and access levels within your system. They provide a flexible way to categorize customers and define their capabilities within your platform.

## Required Fields

To create an account role, you need:

- **Name**: Display name for the role
- **Code**: Unique identifier for the role
- **Description**: Optional detailed description of the role's purpose


## Role Configuration Options

### Default Role Setting

- **Only one role can be set as default** at any time
- Checking the "default role" checkbox automatically disables the previous default role
- The default role is automatically assigned to new customer accounts


## Working with Account Roles

### Creating and Managing Roles

The account roles interface functions similarly to other list views in the system:

1. **Adding roles**: Create new roles by filling in the required fields
2. **Editing roles**: Modify existing role properties as needed
3. **Deleting roles**: Click the "X" button on the right side of any role to remove it


### Viewing Deleted Roles

- Click "Show deleted" to view previously removed roles
- Deleted roles can be reactivated if needed
- This provides a safety net for accidentally deleted roles


## Role Lifecycle Management

### Deleting Roles

To remove an account role:

1. Click the "X" button on the right side of the role in the list
2. Confirm your decision when prompted
3. The role becomes inactive but remains in the system


### Reactivating Roles

To restore a deleted role:

1. Click "Show deleted" to view deactivated roles
2. Select the role you want to reactivate
3. The role becomes available for assignment again


## Integration with Customer Accounts

Account roles are designed to work together with customer accounts under the customers module. For detailed information about how roles are applied to customer accounts and their specific functionality, refer to the customer documentation.

See [technical documentation](/developer-portal/app-development/working-with-customers-and-the-login-process) for how to use the API's.

> **Note**: Account roles integrate with the broader customer management system. Always consider the impact on existing customer accounts when making changes to role configurations.