[[_user-registration]]

=== User Registration

You can enable {project_name} to allow user self registration.  When enabled, the login page has a registration
link the user can click on to create their new account.

When user self registration is enabled it is possible to use the registration form to detect valid usernames and emails.
It is also possible to enable <<_recaptcha,reCAPTCHA Support>>.

Enabling registration is pretty simple.  Go to the
`Realm Settings` left menu and click it.  Then go to the `Login` tab.  There is a `User Registration` switch on this
tab.  Turn it on, then click the `Save` button.

.Login Tab
image:{project_images}/login-tab.png[]

After you enable this setting, a `Register` link should show up on the login page.

.Registration Link
image:{project_images}/registration-link.png[]

Clicking on this link will bring the user to the registration page where they have to enter in some user profile information
and a new password.

.Registration Form
image:{project_images}/registration-form.png[]

You can change the look and feel of the registration form as well as removing or adding additional fields that must be entered.
See the link:{developerguide_link}[{developerguide_name}] for more information.