Skip to content
  • Documentation >
  • Users >
  • User setup >
  • Registration

Register new users

You can allow your users to create accounts by using the /register route. This route leads to a registration form that, when filled in, creates a new user content item in the repository. To give your users a possibility to register themselves, follow the instructions on enabling account registration.

User types

There are two user types defined: users and customers. users are back office users that are involved in creating the page such as editors, and customers are frontend users. To decide where the user should be registered to, you need to specify their user type under the ibexa.system.<scope>.user_type_identifier configuration key.

1
2
3
4
5
ibexa:
    system:
        <scope>:
            user_registration:
                user_type_identifier: user

User groups

By default, new users generated in this way are placed in the Guest accounts group. You can select a different default group in the following section of configuration:

1
2
3
4
5
ibexa:
    system:
        default:
            user_registration:
                group_remote_id: <userGroupContentRemoteId>

Registration form field configuration

To modify the registration form template, add or remove fields under the allowed_field_definitions_identifiers configuration key:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
ibexa:
    system:
        <scope>:
            user_registration:
                user_type_identifier: user
                form:
                    allowed_field_definitions_identifiers:
                        - first_name
                        - last_name
                        - user_account

Other user management templates

You can also modify form templates in the following way:

Changing user password

1
2
3
4
5
6
ibexa:
    system:
        <siteaccess>:
            user_change_password:
                templates:
                    form: <path_to_template>

Password recovery forms

1
2
3
4
ibexa.site_access.config.<siteaccess>.user_forgot_password.templates.form
ibexa.site_access.config.<siteaccess>.user_forgot_password_success.templates.form
ibexa.site_access.config.<siteaccess>.user_forgot_password_login.templates.form
ibexa.site_access.config.<siteaccess>.user_forgot_password.templates.mail

Resetting password

1
2
3
ibexa.site_access.config.<siteaccess>.user_reset_password.templates.form
ibexa.site_access.config.<siteaccess>.user_reset_password.templates.invalid_link
ibexa.site_access.config.<siteaccess>.user_reset_password.templates.success

User settings

1
2
ibexa.site_access.config.<siteaccess>.user_settings.templates.list
ibexa.site_access.config.<siteaccess>.user_settings.templates.update

Changing registration form templates

To change the registration form template, follow the instructions in Invitation and registration form templates.

View as Markdown View on GitHub