第4章 Custom User Attributes
You can add custom user attributes to the registration page and account management console with a custom theme. This chapter describes how to add attributes to a custom theme, but you should refer to the Themes chapter on how to create a custom theme.
4.1. Registration Page
To be able to enter custom attributes in the registration page copy the template themes/base/login/register.ftl
to the login type of your custom theme. Then open the copy in an editor.
As an example to add a mobile number to the registration page add the following snippet to the form:
<div class="form-group"> <div class="${properties.kcLabelWrapperClass!}"> <label for="user.attributes.mobile" class="${properties.kcLabelClass!}">Mobile number</label> </div> <div class="${properties.kcInputWrapperClass!}"> <input type="text" class="${properties.kcInputClass!}" id="user.attributes.mobile" name="user.attributes.mobile" value="${(register.formData['user.attributes.mobile']!'')}"/> </div> </div>
Ensure the name of the input html element starts with user.attributes.
. In the example above, the attribute will be stored by Keycloak with the name mobile
.
To see the changes make sure your realm is using your custom theme for the login theme and open the registration page.