# Roles & Permissions

> Manage roles and their associated permissions.

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/roles` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `RolesPage` |
| Source | `src/app/(app)/admin/roles/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.roles.title` |
| Description i18n key | `admin.roles.subtitle` |
| Permission | `admin.roles.view` |
| Nav group | `users` |
| Sidebar label | Roles |

## Summary (for AI)

**Roles & Permissions** Manage roles and their associated permissions. Sidebar label: “Roles”. Requires permission `admin.roles.view`. Key UI: Are you sure you want to delete this role?; Create Role; Your role; Edit; Duplicate.

## How to guide users

1. Open Admin sidebar.
2. Open **Roles**, then **Roles & Permissions**.
3. Direct URL: `/admin/roles`.
4. User needs permission `admin.roles.view` (or `admin.root`).

## Sections on this page

- Managing Roles
- Granular Permissions
- Security First

## Notable UI actions / labels

- Are you sure you want to delete this role?
- Create Role
- Your role
- Edit
- Duplicate

## Widget slugs

- [`admin-roles`](../widgets/admin-roles.md)

## Related APIs / hooks

- `/api/admin/permissions`
- `/api/admin/roles`

Hooks: `usePersistedListFilters`, `usePluginWidgets`, `useSession`