Skip to main content
Version: Divi 5

Field Mapping in Divi Form Builder (Divi 5)

Field mapping connects form fields to WordPress post fields, taxonomies, ACF fields, user fields, and custom meta. Use it with Post/Product/CPT forms, User registration forms, and Login forms. In Divi 5, mapping is set per field in the Form module’s Content tab.

Where to find it (Divi 5)​

  1. Open the page in the Divi 5 Visual Builder.
  2. Select the Form module → Content tab.
  3. Select the field you want to map.
  4. Open the Field Mapping section and choose the Field Mapping Type.

Field mapping types​

  • Post Default Field — Post title, content, excerpt, status, slug, featured image, parent, post type, date.
  • Taxonomy — Categories, tags, or custom taxonomies for the post type.
  • ACF Field — Map to Advanced Custom Fields (ACF) fields.
  • Custom Meta Field — Custom meta for posts, pages, products, or CPTs.
  • User Field / User Meta Field — For registration or login forms.
  • Custom — For custom handling (developers).

Select the type, then pick the specific target (e.g. which ACF field or taxonomy).

Setup sequence​

  1. Choose the correct Form Type first (Post/Product/CPT, User Registration, or Login).
  2. Build fields and lock in Field IDs before mapping.
  3. Map one field at a time and test each save target.

Verify it works​

  1. Submit a test entry from the front end.
  2. Open the target post/user and confirm mapped values were saved correctly.
  3. Re-test after changing field IDs, post type, or ACF keys.

Common pitfalls​

  • Mapping fails when target fields are missing or renamed.
  • ACF mappings fail when field keys/names do not match expected targets.
  • Wrong form type can hide or invalidate available mapping options.

What's Next​

  • Review Form Types to confirm the right form workflow.
  • Add Edit post if users need front-end updates after creation.
  • Continue with Form settings for confirmation email and redirects.