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[]

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.
KEYCLOAK-16186-2 modularizes files (#39) 2020-11-11 16:21:21 +00:00			`[id="proc-creating-realm-roles_{context}"]`
roles 2016-05-25 15:08:14 +00:00
applying indentation using leveloffsets 2020-12-01 23:16:31 +00:00			`= Creating a Realm Role`
KEYCLOAK-16186-2 modularizes files (#39) 2020-11-11 16:21:21 +00:00			`[role="_abstract"]`
INcorporates feedback (#40) 2020-11-13 14:09:23 +00:00			`Realm-level roles are a namespace for defining your roles. To see the list of roles, click Roles in the menu.`
roles 2016-05-25 15:08:14 +00:00
Convert documentation to AsciiDoctor 2017-08-28 12:50:14 +00:00			`image:{project_images}/roles.png[]`
roles 2016-05-25 15:08:14 +00:00
KEYCLOAK-16186 Initial rewording (#38) * KEYCLOAK-16186 Initial rewording * Post workding feedback * post visual review changes * more post feedback changes * Update default-roles.adoc Minor correction where you include my incorrect suggestion. Co-authored-by: andymunro <48995441+andymunro@users.noreply.github.com> 2020-11-10 18:11:10 +00:00			`.Procedure`
			`. Click Add Role.`
Applying bold and other changes to merge roles and groups topics. 2020-11-11 17:08:48 +00:00			`. Enter a Role Name.`
			`. Enter a Description.`
KEYCLOAK-16186 Initial rewording (#38) * KEYCLOAK-16186 Initial rewording * Post workding feedback * post visual review changes * more post feedback changes * Update default-roles.adoc Minor correction where you include my incorrect suggestion. Co-authored-by: andymunro <48995441+andymunro@users.noreply.github.com> 2020-11-10 18:11:10 +00:00			`. Click Save.`
roles 2016-05-25 15:08:14 +00:00
			`.Add Role`
Convert documentation to AsciiDoctor 2017-08-28 12:50:14 +00:00			`image:{project_images}/role.png[]`
roles 2016-05-25 15:08:14 +00:00
KEYCLOAK-15771 Updates based on peer editing agreements on clients topics and making corrections to roles and groups chapter. 2020-11-17 20:40:14 +00:00			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.