keycloak-scim/server_admin/topics/roles-groups/proc-creating-realm-roles.adoc

[id="proc-creating-realm-roles_{context}"]

= Creating a realm role
[role="_abstract"]
Realm-level roles are a namespace for defining your roles. To see the list of roles, click *Roles* in the menu.

image:{project_images}/roles.png[]

.Procedure
. Click *Add Role*.
. Enter a *Role Name*.
. Enter a *Description*.
. Click *Save*.

.Add role
image:{project_images}/role.png[Add role]

The *description* field can be localizable by specifying a substitution variable with `$\{var-name}` strings. The localized value is configured to your theme within the themes property files. See the link:{developerguide_link}[{developerguide_name}] for more details.