Help Center/Governance, RBAC & Security Desk/How to clone a role under a new key
Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read

How to clone a role under a new key

Clone copies a role's configuration into a new role named "<name> (Copy)" so you can adjust it without touching the original.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Click "Clone"

On /admin/rbac/roles click "Clone" on the source role card.

2

Enter the new key

A browser prompt asks "Clone "<roleKey>" as (new role key):" with "<roleKey>_copy" prefilled. Type a unique key and confirm; cancelling the prompt aborts.

3

Review the copy

The new card appears named "<original name> (Copy)". Use "Edit" to rename it and adjust permissions.

Expected Operational Outcome

A new role with the source's settings exists under the key you typed.

Troubleshooting & Failure Modes

Symptom: Role "x" already exists. / Source role not found
Likely Cause: The new key is taken or the source vanished.
Resolution: Pick another key or refresh the page.

Was this guide helpful?

Help us refine our platform documentation