Sign-up Form

5 minutes to read

A Sign-up Form allows users to self-register for your app. This type of form can be created with public access permissions. It is possible to assign a default role or group to all the users who registered with a particular Sign-up Form.

When signing up, users must provide an email address and password.

New or inactive users: If the email address is not found, is inactive, or has an expired activation link, the user receives an email with a new activation link valid for 1 hour. Clicking the link after it expires or after signing up again will direct them to an expiration notice.
Existing active users: If the email is already associated with an active account, the user receives an email with a password reset link.

Note: After seven days, the link is removed from the database, and when clicked, it navigates to the Page not found (404) error. 

Steps to create Sign-up Forms

In the upper panel, select the Add elements button.
Select User management → Sign-up Form.
Select a directory to which the user should be assigned.
From the Available fields panel, select additional fields you want to use in your form alongside Email and Password (required). Click the fields or drag them to the Selected fields section. To add all available fields, click Select all.
Optional: Configure sections in which you want to display groups of fields:
1. In the Elements panel, click Add > Section and select the new section.
2. On the General tab, enter the section heading and description to display on the form.
3. On the Layout tab, select the number of columns in which you want to display the fields. The columns are of equal width.
4. For each section that you want to display, repeat steps a. through c.
5. Rearrange the order of sections using drag-and-drop.
In the General and Appearance tabs, configure additional settings. The options available depend on the selected form element.

For Email and Password, configure:

General information

Label – instructional text or name for a field.
Hint – text displayed in a tooltip.
Placeholder text – displays example content for a field.
Add confirmation field – requires an app user to verify their input. For this field, you can configure:
- Confirmation label – label for a confirmation field.
- Confirmation hint – text displayed in a confirmation field tooltip.
- Confirmation placeholder – example content for a field.
Default value – (for Email only) value that is automatically populated when a form is displayed. The value is assigned to form fields to facilitate the process of filling a form.
You can pass a static value by inserting it in the Default value field and a dynamic value using parameters.

Appearance

Field size – field width. You can select between:
- Auto – defines the width of a field by the size of the content inside a field,
- Fixed – allows for setting the precise size of a field width in pixels [1-9999px]. The content of a field will not be visible if it exceeds the set size.

Label position – you can choose between Left, Top, Float, or No label.
Next element position – select if the next element should appear Below or Inline.

Learn about options available for other element types.

Select Next.
Define the roles you want to assign to all users that sign up with an app.

1. From the left Elements panel, select Roles.
2. In the Role assignment section, you can choose:

- - Preselected to predefine roles for the app users.
  - User-selectable to let users select roles by themselves.

Note: Only roles from the current application are available.

Select Groups to define users’ data and application access.

1. From the left Elements panel, select Groups.
2. In the Group assignment section, you can choose:

- - Preselected to predefine groups for the app users. Only static groups with the previously selected directory or a directory used as a data source are available for this option.
  - User-selectable to let users select groups by themselves. Only static groups with the previously selected directory are available for this option.

Select Save.
You can customize email templates and destination pages shown to the app user.

To preview or modify the templates with email messages that will be sent to app users (Activate your account and Email address already registered):

In the right panel, select Destination pages > Notifications.
Click the pen icon near the template’s name, introduce the changes, and select Save.

To preview or modify the destination pages displayed for a user (Form submission successful, User activation successful, and Activation link expired or invalid):

In the right panel, select Destination pages.
Click the pen icon near the page’s name, introduce the changes, and select Save.

Important: The Form submission successful destination page of the Sign–up Form does not include all the data source parameters but only the fields whose values were entered by the app user. This approach prevents from revealing directory user data in the confirmation page if the app user enters an email address that is already used by an existing directory user.

You can edit the messages for email templates and destination pages with HTML Editor or Custom Code editing options. The text editor allows also for inserting parameters from data source fields (including lookup parameters), directory parameters, or app parameters for the message to pass the values dynamically. To restore a text to its original version by removing all your edits, select Restore email template.

After creating a Sign-up Form, in the right panel, you can edit its source and fields. This option may be helpful when you want to add or remove fields from a data source or change a data source to a different directory.