Divi Form Builder Field Mapping

The Field Mapping feature in Divi Form Builder allows you to map form fields to various WordPress fields, taxonomies, and ACF fields within your WordPress site. This functionality ensures that the data collected through your forms is properly stored and utilized within your WordPress environment. Field Mapping can be used with the following types of forms:

• Create Type Forms
• User Registration Forms
• Login Forms

Accessing Field Mapping

1. Navigate to the Form Field Settings: Within the Form module settings, open the field settings you want to set up a mapping, scroll down, and click on the Field Mapping section.
2. Select Field Mapping Type: Choose the appropriate field mapping type from the dropdown menu.

Field Mapping Types

The available field mapping types include:

• Post Default Field: Maps to default fields of posts, pages, products, or custom post types (CPT).
• Various Taxonomy Fields: Maps to taxonomy fields associated with various post types.
• ACF Field: Maps to Advanced Custom Fields (ACF).
• Custom Meta Field: Maps to custom meta fields for posts, pages, products, or CPTs.
• User Field: Maps to user fields from the register/login form.
• User Meta Field: Maps to user meta fields from the register/login form.
• Custom: For advanced users or developers, allows for custom field mapping.

Default Field Mapping

When Field Mapping Type is set toPost Default Field, you can map to the following default fields:

• Post Title
• Post Content
• Post Excerpt
• Post Status
• Post Slug
• Featured Image
• Parent Post
• Post Type
• Post Date

Taxonomy Mapping

If you choose a taxonomy field mapping type, you will need to map it to the relevant taxonomy. For example:

• Post Taxonomy Field: Choose from categories, tags, or custom taxonomies associated with posts.

ACF Field Mapping

For mapping fields to Advanced Custom Fields (ACF):

1. Select ACF Field from the Field Mapping Type dropdown.
2. Choose the specific ACF field you want to map from the ACF Field Mapping dropdown.

tip

If you are using the free gallery hack with the ACF Group using Divi Machine, map only the ACF group field, not the individual image sub-fields.

Custom Meta Field Mapping

To map to a custom meta field:

1. Select Custom Meta Field from the field mapping type dropdown.
2. Enter the meta field name in the Custom Meta Field Mapping input box.

User Field and User Meta Field Mapping

For user-related field mappings in user registration and login forms:

• User Field: Map to default user fields such as username, first name, last name, email, etc.
• User Meta Field: Enter the user meta field name for custom user data.

Default User Field Mapping Options

When User Field is selected, you can map to the following user fields:

• User Name
• First Name
• Last Name
• Nick Name
• Login Name
• Email Address
• User URL
• Display Name
• Password
• Password Confirm
• User Role

Auto Detect from Mapped Field

The Auto Detect feature allows you to fetch options for choice type fields (Radio, Checkbox, Select) from the mapped fields. This can be particularly useful when using an ACF choice type field in a normal contact form. There are 2 types of fields you can use auto detection:

1. Taxonomy Fields: This includes category, tags, and custom taxonomy fields.
2. ACF Fields: You can auto detect values from ACF choice type fields such as radio, checkbox, select, etc.

To enable Auto Detect, enable the option Auto Detect from mapped field? in the Main Options section of a field settings.

This feature will automatically fetch the options from the mapped ACF or taxonomy fields, ensuring that your form fields are dynamically populated with the correct choices.

By following these guidelines, you can effectively utilize the Field Mapping feature in Divi Form Builder to enhance the functionality and data management of your WordPress site.