XWiki Standard 9.8.1 Documentation » Rights Overview » Customize the User Registration Process

Customize the User Registration Process

You can configure your Wiki to be open, so that everyone can edit or comment without having to register or to log in. To do this, simply grant the "view" and "comment" rights to the pseudo-user named XWiki.XWikiGuest.

In order to require users to confirm their registration and to provide a valid email address, click the DrawerMenuIcon.png button to open the drawer menu, then click on "Administer Wiki". 


In the wiki preferences page, click on "Users & Rights" -> "Registration" in the accordion menu to the left.


Next, set "Use email verification" to "YES" which means that an email will be sent to the email address the user registered with. The "Authentication Active Check" option set to "YES" will prevent the users from logging in without entering the token which was previously sent by email. The content of the message is set in the "Validation E-Mail Content" text area.


Registration Options

  • Registration page heading is the line displayed at the top of the page for the users who are registering or who have just registered.
  • Confirmation E-Mail Content requires that you set "Use email verification" and "Authentication Active Check" to "YES". These settings are optional but you will still have to provide a link to activate the account.


  • Welcome Message requires that you set "User email verification" to "YES" and modify the "Validation E-Mail Content" so that it doesn't mention the verification since it is not needed anymore.


  • Enable Javascript field validation enables or disables the Live Validation. Note that if this option is set to "FALSE", the fields will still be validated server-side.
  • Default field okay message refers to the message displayed by the Live Validation when the fields have been correctly filled in.
  • Enable login button enables or disables the button the users need to click on in order to log in.
  • Enable automatic login is disabled by default. If enabled, the user is automatically logged in after a successful registration.
  • Redirect here after registration refers to the URL of the wiki page the user will be redirected to after clicking the "Login" button.
  • Require captcha to register requires the user to solve a CAPTCHA in order to register.
  • Registration Successful Message is displayed when the user has successfully registered.
More details about the registration page are available by navigating to XWiki.RegistrationHelp.


Related Pages

Trying to decide between Cloud and On Premise? See the comparison on the XWiki Help Center.

Search this space