Storing Data from Widgets to Contact Fields

When creating subscription forms, you can add the following fields and send their data to mapped contact fields:

  • Text input
  • Text area
  • Date
  • Calendar
  • Checkbox
  • Dropdown
  • Radio

This can enrich a contact profile with data gathered in a widget to improve message personalization.

These fields are available for all types of subscription forms:

  • Inline
  • Pop Up
  • Floating box
  • Floating bar

When a user enters data into the fields and subscribes using the widget, a new contact is created, or an existing contact is updated.

The information selected or entered into the widget fields is added to the corresponding contact fields.

Stored data in contact fields

Stored data in contact fields

To learn more about creating widgets, read Setting up Widgets for your Site.

Mapping the field data to a contact field

When you add one of the fields to your subscription form, the Process collected data as sidebar opens, offering two options:

  • Contact field: This option allows you to map the data entered into this field to a contact field that you created in your account.
  • Event parameter: This option allows collected data processing as event parameters.

To map the widget field to the contact field:

  1. Add one of the following fields to your subscription form.
    • Text input
    • Text area
    • Date
    • Calendar
    • Checkbox
    • Dropdown
    • Radio
      The Process collected data as sidebar opens.
  2. Select the Contact field option and click Next.
Selecting Contact field

Selecting Contact field

  1. Select the contact field existing in your account that you want to map the data to.
    You can add a new field, see Adding a new field to learn more.

The fields that are not included in a list are displayed at the top of the menu. To see fields in a list, expand the list by clicking the down arrow.

Adding the contact field

Adding the contact field

📘

Note

The field names displayed in gray cannot be added for the selected field type.

You can map the widget fields to the following types of contact fields:

Widget fieldContact field type
Text input● Text field
● Number
● Fractional number
Text area● Text area
Date● Date
Calendar● Date
Checkbox● Checkbox list
Dropdown● Dropdown list
Radio● Dropdown list

After selecting the contact field for the checkbox, dropdown, or radio fields, the Edit options window opens. Edit the options as described below, then click Done:

  • Change the names of the options. Enter the option name in the Names of options in the widget column.
  • Show or hide options. Enable or disable the slide button in the Show option column to show or hide the option in the widget.
  • Change the option position. Use the six dots icon to drag and drop the option to another position.
Editing options

Editing options

Adding a new field

To add a new field in the Select contact field window:

  1. Click + Add a field at the bottom of the window.
  1. In the Add a field window, select the radio button beside the existing list.

Or,

Select the radio button beside + Create a new list for this field and enter the list name to create a new list.

Selecting or creating a list

Selecting or creating a list

  1. Click Next.
  2. Enter the field name and select the field type from the Field type dropdown list.

📘

Note

The personalization key is created automatically based on the list name. Point to the interrogation (?) icon to learn more.

Entering the field parameters

Entering the field parameters

  1. Click Done.

Configuring the added fields

After adding a field to your widget, you can edit its configuration in the General tab.

General tab

General tab

The sections available in the General tab depend on the widget type. The table below provides details about each section.

SectionDescriptionAvailable for fields
PlaceholderThe text entered into the Placeholder field is shown as a placeholder in the field added to the widget.● Text input
● Text area
● Dropdown
Collected data storageThis section displays the selected contact field.
To choose another field, click the Change button and select another field.
● Text input
● Text area
● Checkbox
● Dropdown
● Radio
● Calendar
● Date
ValidationDisplays validation parameters.● Text input
● Text area
● Checkbox
● Dropdown
● Radio
● Calendar
● Date
OptionsShows the names of options in the selected field.
Click the Edit for this widget button to edit options.
● Calendar