Skip to main content
Version: Divi 5

User Registration Form

Building a user registration form in Divi 5​

Use the Form module in the Divi 5 Visual Builder to create registration forms that use WordPress user fields and, optionally, ACF fields assigned to users.

When to use this form type​

Use User Registration Form when you need frontend account creation (or account updates when configured as user-edit behavior).

Prerequisites​

  • User registration requirements planned (required fields, role behavior, redirect)
  • Optional ACF user field group created if collecting additional profile data
  • A test user flow prepared for frontend validation

Step 1: Add the Form module​

  1. Open the page in the Divi 5 Visual Builder.
  2. Insert the Form module where the registration form should appear.

Step 2: Define form settings​

  1. Select the Form module and open the Content tab.
  2. Set Form Title and a unique Form ID.
  3. Set Form Type to the User Registration option.
  4. Set Submit Button Text (e.g. "Register").

Step 3: Plan your fields​

Registration forms can use:

  • WordPress user fields — e.g. Login Name, Email, Password (required for registration).
  • ACF user fields — create a field group assigned to Users in ACF and map form fields to those meta fields.

Include at least Login Name and Email (and Password for registration).

Step 4: Add form fields​

  1. In the Content tab, add fields with Add New Form Field.
  2. For each field set Field Title, Admin Title, Field ID, and Field Type (Input, Email, Password, etc.).

See Field types for all field types and options.

Step 5: Map fields​

  1. For default WordPress user fields: set Field Mapping Type to User Field (Register/Login Form Only) and choose the user field (e.g. Login Name, Email, Password).
  2. For ACF user meta: set Field Mapping Type to User Meta Field (Register/Login Form Only) and enter the meta field name.

Ensure Login Name and Email are mapped for registration.

Step 6: Customize the form​

Use the Content and Design tabs for layout, redirect after submit, and per-field styling or conditional logic.

note

Some features (e.g. email notifications) may not apply to Registration forms.

Verify it works​

  1. Submit a test registration from the frontend.
  2. Confirm account creation succeeds and fields are saved correctly.
  3. Confirm role/auto-login behavior matches your settings.
  4. Confirm duplicate usernames/emails and invalid values show clear error feedback.

Common setup mistakes​

  • Missing mapping for required user fields
  • Using the wrong mapping type for WordPress user vs user meta fields
  • Forgetting to test with both valid and invalid registration data
  • Not validating registration flow after enabling user edit mode

What's Next​