Create and edit forms

You can create new forms in the Forms application:

1. Open the Forms application.
2. Select New form.

The system creates a new form and opens the Form Builder.

Form Builder is a graphical interface for designing forms in Xperience. Editors modify the overall form layout, add various types of fields, and adjust their position in the form. The resulting form appears as it will display on the live site.

Using Form Builder, editors can:

• Set form layout
• Add fields
• Move and reorder fields
• Delete fields
• Set the submit button text

In addition to the Form Builder interface, the options panel on the right can be used to:

• Access form submissions collected from users
• Configure general form properties and behavior
• Choose actions that occur after the form is submitted

Set form layout

The layout of a form is composed of sections. Each section contains one or more zones to which you can add fields.

The system provides a Default section that organizes fields in a basic single-column layout. The project’s developers may prepare additional types of sections that allow you to create more advanced form layouts.

To edit the layout of a form, add or adjust sections using gray UI elements:

• Add section – select a gray plus button located on the left to insert a new section. The list of available section types depends on the implementation of your project.
• Move section – hover over a section and drag it by the handle among the section buttons on the right.
• Change section type – you can change the type of a section to adjust the form’s layout. Hover over the section you want to modify, select the Change section type button, and select the section type you wish to use.
• Configure section – opens a dialog where you can set values for properties that affect the content, appearance, or behavior of the section. The Configure button is only available for sections with configurable properties. Check with your project’s administrators or developers for more information about the available section types and their properties.
• Delete section – hover over the section you want to remove and select the delete button on the right. This also deletes all form fields in the section, which can lead to a loss of data in existing forms.

Changes made to sections are saved automatically. After creating the required form layout through sections, you can move fields between the resulting zones.

Add fields

Select the purple plus buttons in the form editing area to add new fields. The Fields dialog opens, which allows you to add fields from two categories:

• Featured – offers fields frequently included in forms, preconfigured for easy and quick use. Many featured fields automatically map the submitted information to the contact representing the visitor in the system (for visitors who give consent). See the contact attribute mapping section for more details.
• New field – allows editors to select a basic field type and configure the field from scratch. Information collected by these fields is not automatically used by the system (unless configured otherwise), but can be accessed in the form’s submissions.

The form saves automatically each time a new field is added. 

Hide featured fields

If any of the featured fields are not relevant for your forms, you can hide them from the Fields dialog that appears when adding new form fields:

1. Switch to the Featured fields tab in the left-side navigation menu of the Forms application.
2. Toggle the Visibility in forms switcher for the corresponding featured fields.

Field properties

Fields in the form are configurable. You can change a field’s label, tooltip, default value, and other properties depending on the field type via the properties dialog.

1. Select the field you wish to configure.
2. Open the properties dialog by selecting configure ().
   
3. Select Apply to save your changes.

Map form submission to contact attributes

Xperience can use the information collected via forms to update contacts representing website visitors in the system. If a visitor submits a form, the system automatically transfers the entered values into the data of a matching contact (for visitors who give consent). You can also use the same approach to update the data of existing contacts when a visitor provides new information.

Mapping links a form field to a specific contact attribute. You control how form fields are mapped via the Mapped to contact attribute field property.

For example, if the form has a field where users enter their email address, you can choose this field for the Email contact attribute. When a user submits the form, the system automatically saves the field’s value as the email address of the contact representing the given user.

Contact segmentation

You can use forms to segment your contacts. For example, you can build a contact group for visitors who have submitted the Contact Us form.

Move and reorder fields

To change the order of existing fields or move them between different zones in the form layout:

1. Select a field in the form.
2. Drag the field by the handle () or the header that appears when you select a field.

Delete fields

To delete fields from the form:

1. Select the field you wish to remove.
2. Select the delete () icon in the upper right.
3. Confirm the removal via the popup dialog.

Set the submit button text

Every form contains a button that allows users to submit the entered data. The submit button is positioned at the bottom of the form and cannot be moved.

The Form Builder allows editors to change the text of the submit button’s label:

1. Hover over the submit button at the bottom of the form.
2. Open the button’s properties dialog by selecting configure ().
3. Enter the desired text into the Submit button text property.
4. Select Apply to save the change.