Roles

Roles are containers for permissions. Each role maps to a Keycloak role — users with a given Keycloak role inherit all permissions configured for that role in Valtimo.

---

Creating a role

1

Navigate to Admin in the sidebar

2

Click Access Control

3

Click Add new role

4

Select a role from the dropdown, or click Enter manually to type a custom role key

Add role modal

5

Click Create

The dropdown shows roles from Keycloak that are not yet configured in Valtimo. Use Enter manually when the role does not exist in Keycloak yet or when you need a custom key.

---

Editing a role

To rename a role:

1

Click on the role in the list to open its editor

2

Click the More menu (three dots) in the header

3

Select Edit

4

Enter the new role key and click Save

---

Deleting roles

1

Select one or more roles using the checkboxes

2

Click Delete in the action bar

3

Confirm the deletion

Deleting a role removes all its permissions. This action cannot be undone.

---

Exporting roles

Roles and their permissions can be exported as JSON files for backup or migration.

1

Select one or more roles using the checkboxes

2

Click Export in the action bar

3

Choose an export format

Export options

4

Click Export to download the file(s)

Option	Description
One JSON file	All selected roles in a single file
Separate files per role	One JSON file per role (downloaded as separate files)