--- title: Form configuration description: Configuration options for the form builder, including properties, fields, and a toolbox for further customization. component: pingone page_id: pingone:user_experience:p1_form_configuration canonical_url: https://docs.pingidentity.com/pingone/user_experience/p1_form_configuration.html revdate: June 26, 2025 page_aliases: ["p1_form_fields.adoc", "p1_form_properties.adoc", "p1_form_toolbox.adoc"] section_ids: properties: Properties fields: Fields custom-fields: Custom Fields pingone-attribute-fields: PingOne Attribute Fields user-account: User Account contact: Contact name: Name language: Language address: Address photo: Photo field-properties: Field properties toolbox: Toolbox mfa-components: MFA components --- # Form configuration ## Properties You can view and edit form properties on the **Properties** tab. | Property | Description | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Form Name** | The name of the form. This name is used internally and isn't visible to the end user.This property is required. | | **Form Description** | A description of the form.This description is used internally and is not visible to the end user. | | **Localization Display** | PingOne localization support. Valid displays are:- **Display translations** Displays all translated strings on the form. If custom strings exist, ensure that keys and translations for these strings are included to prevent partially translated forms from displaying. - **Display keys** Displays the translation keys for all strings on the form. This option should be used only for testing purposes.- **Display only the default language** Displays the default language on the form without localization information. | | **Show "Required" field indicators** | When selected, the form indicates the fields that the user must complete. | | **Show "Optional" field indicators** | When selected, the form indicates the fields that are optional for the user.This property is selected by default. | | **Enable for text fields** | When selected, autocomplete tools are enabled for text fields. This feature provides assistive tools to make the form more accessible for users. | | **Enable for password fields** | When selected, autocomplete tools are enabled for password fields. This feature provides assistive tools to make the form more accessible for users. | ## Fields You can add any of the following fields on the **Fields** tab. After adding the fields, you can configure some of the field properties. You can add additional user information categories by going to **Directory > User Attributes** in PingOne. After you add them, these new categories are available as field types. | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | When a form is modified and saved, it could have an immediate impact on a production flow depending on how it's used in DaVinci. If you add new fields, you must go into the DaVinci flow and modify the mappings with new or updated fields. | ### Custom Fields | Field | Description | | ---------------------- | ------------------------------------------------------------------------------ | | **Checkbox List** | A section with a list from which a user can select one or more options. | | **Combobox** | A drop-down element for selecting from multiple possible values. | | **Dropdown** | A drop-down element. | | **Password** | A field for a user's password. | | **Phone Number Input** | A field for a user's country code, phone number, and extension for validation. | | **Radio Button List** | A section of options where a user can only select one. | | **Text Input** | A field for a user's text input. | ### PingOne Attribute Fields #### User Account | Field | Description | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Username** | The account username. | | **Password** | A field that allows the user to enter their current PingOne password or set a new one. Enable **Verify Password** to require the user to confirm the new password. Enable **Show Password Requirements** to show requirements set by the environment's default password policy. | | **Current Password** | A field that prompts the user to enter their current PingOne password for authentication. | | **New Password** | A field that allows the user to set a new PingOne password. Enable **Verify Password** to require the user to confirm the new password. Enable **Show Password Requirements** to show requirements set by the environment's default password policy. | | **Recovery Code** | The recovery code for the user's account. This field can be used with the **New Password** field for password recovery. | | **Type** | The type of user. Must be `PING_ONE` or `EXTERNAL`. Use this field for forms that allow administrators to create users | #### Contact | Field | Description | | ----------------- | -------------------------------- | | **Email Address** | The user's email address. | | **Primary Phone** | The user's primary phone number. | | **Mobile Phone** | The user's mobile phone number. | #### Name | Field | Description | | -------------------- | ----------------------------------------- | | **Formatted** | The form of the user's name. | | **Given Name** | The user's given name. | | **Middle Name** | The user's middle name. | | **Family Name** | The user's family name. | | **Nickname** | The user's nickname. | | **Title** | The user's title. | | **Honorific Prefix** | The honorific prefix for the user's name. | | **Honorific Suffix** | The honorific suffix for the user's name. | #### Language | Field | Description | | ---------------------- | ------------------------------ | | **Locale** | The user's locale. | | **Preferred Language** | The user's preferred language. | #### Address | Field | Description | | ------------------- | ----------------------------- | | **Street Address** | The street address. | | **City / Locality** | The town or locale. | | **Region** | The state or region. | | **Postal Code** | The zip code or postal code. | | **Country Code** | The three-digit country code. | | **Timezone** | The user's time zone. | #### Photo | Field | Description | | --------------- | ----------------------------- | | **Photos Link** | The URL for the user's photo. | ### Field properties Clicking a field already in your form displays the field properties in the sidebar. | Property | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Field Type** | The type of field, such as **Text Input** or **Password**. | | **Key** | The key value for the provided data. This property can only be edited for custom fields. | | **Label** | The field label that's displayed for the end user. | | **Label Position** | Configures whether the label displays inside the field or above the field. Valid positions are:- **Inside** - **Above** | | **Input Type** | The type of input provided by the user. Valid types are:- **Text** A text field with option validation. - **Password** A password-specific field with optional confirmation. - **Dropdown** A drop-down list with one or more options you can configure under **Options**. - **ComboBox** A drop-down menu with one or more options you can configure under **Options**. - **Radio** A set of radio buttons. - **Single Checkbox** A single checkbox that can be configured to display as a checkbox or toggle. - **Checkbox** A set of checkboxes with one or more options. - **Phone Number** Turns field into a phone number input component. | | **Width** | The width of the field. Valid values are:- **Flex** (fills the available space) - **25%** - **50%** - **75%** | | **Validation Type** | If you selected **Text** as the input type, this option lets you validate the text. Valid values are:- **None** - **Custom**If you select **Custom**, the **Regex** and **Error Message** fields show. The **Regex** value is used to validate the text, and the **Error Message** value appears if the text is invalid. | | **Verify Password** | If you selected **Password** as the input type, this checkbox adds a field to verify the provided password. | | **Field Required** | This checkbox indicates that the field is required. The form properties determine whether optional or required fields are indicated. | ## Toolbox You can add any of the following components on the **Toolbox** tab to customize the layout and appearance of the form. | Tool | Description | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Agreement** | The title and full text of an agreement from **User Experience > Agreements**. | | **Divider** | A horizontal divider.Add optional text to your divider in the **Label** field and align the text with **Label Alignment**. | | **Empty Block** | An empty space that can be moved and resized. | | **Error Display** | A space that shows any form or flow-level errors. | | **Flow Button** | A customizable button to include in a form. | | **Flow Link** | A custom link to include in a form. For example, you can add a **Forgot Password** link for password reset. | | **Google reCAPTCHA v2** | A Google reCAPTCHA tool can distinguish between human and automated accesses.You can customize the alignment, size, and theme of the reCAPTCHA tool. You must supply your environment with the Site Key and Secret Key from your Google account to enable this tool. Click Global Google reCAPTCHA Settings to view or update this information. This element can be included only on forms designed for use in flows. | | **Polling** | An activity indicator.This component also enables polling functionality and configuration in the PingOne Forms connector. | | **QR Code** | A scannable QR code.This component is useful for several use cases, including prompting an end user to:- Open a website or app installer on their mobile device - Start an identity verification process on their mobile device - Pair a mobile app or authenticator for MFA | | **Rich Text** | A block of custom text. This legacy component will be deprecated in 2025. Use Translatable Rich Text instead. | | **Social Login** | A social login button. | | **Translatable Rich Text** | A block of custom text that can be translated. This field is preferred because it can be localized for end users. This field also supports an optional icon to the left of the text. | | **Submit Button** | A submit button.The button is removable. Forms configured with MFA components don't require an additional submit button. | | **Show Hidden** | When selected, displays any hidden elements. | ### MFA components You can use MFA components to create MFA forms for device authentication, device registration, and FIDO2 registration or authentication in your PingOne DaVinci flow. | Tool | Description | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **MFA - Device Selection Authentication** | Provides multiple authentication methods defined by the MFA policy or device list configured in your PingOne Forms connector. On the DaVinci canvas, forms with these components show a dynamic outcome list when you select a specific MFA policy. Otherwise, the node shows all possible outcomes. | | **MFA - Device Selection Registration** | Provides multiple registration methods defined by the MFA policy or device list configured in your PingOne Forms connector. On the DaVinci canvas, forms with these components show a dynamic outcome list when you select a specific MFA policy. Otherwise, the node shows all possible outcomes. | | **FIDO2** | A submit button for FIDO2 registration or authentication forms. |