How to Add Custom Fields to Magento 2 Registration Form

The default Magento 2 registration form collects five fields: first name, last name, email, password, and password confirmation. That's enough for a simple B2C store, but it falls short the moment you need additional information at signup.

Before diving into the solution, here's what you're working against with the built-in registration form:

Adding custom fields to the default form requires creating a setup_patch for each attribute, writing a plugin for the registration controller, and modifying the .phtml template. Every Magento upgrade risks breaking these customizations. WebForms avoids all of this — fields are configured in the admin panel without writing code.

Follow these steps to replace the default registration form with a custom WebForms form. The entire setup takes about 15 minutes.

Step 1: Install WebForms Suite + Customer Registration

Add the MageMe Composer repository and install both packages from your Magento root directory:

composer config repositories.mageme composer https://repo.mageme.com
composer require mageme/module-webforms-3
composer require mageme/module-webforms-3-customer-registration
php bin/magento module:enable MageMe_Core MageMe_WebForms MageMe_WebFormsCustomerRegistration
php bin/magento setup:upgrade

Composer will prompt for your authentication key — find it in the Composer Repository section of your MageMe account.

Log out and back into the Magento admin, then activate your license at Stores → Configuration → MageMe Extensions → Licenses.

Note: Customer registration requires WebForms Suite + the Customer Registration add-on. The free WebForms Lite handles contact forms, surveys, and inquiries but cannot create customer accounts. See the full installation guide for details.

Step 2: Create the Registration Form

1. Go to Content → WebForms → Manage Forms in the Magento admin
2. Click Add New Form
3. Set the form name to "Customer Registration" (or any name you prefer)
4. Under General Settings, configure the success message and redirect URL (e.g., customer dashboard)
5. Under Email Settings, set the notification recipients — the sales team, admin, or both

Step 3: Add Custom Fields

Click Add Field to start building your form. Common registration fields:

Step 4: Configure CAPTCHA

Protect your registration form from bot signups. In the form's CAPTCHA tab, choose your preferred method: reCAPTCHA v2/v3, hCaptcha, or Cloudflare Turnstile. All three are supported in both Lite and Suite. See our spam protection guide for a detailed comparison.

Step 5: Place the Form on the Registration Page

You have several options for displaying the form:

• CMS Widget: Add a WebForms widget to any CMS page or block. Navigate to Content → Widgets, create a new widget of type "WebForms", select your registration form, and assign it to the registration page layout.
• Contact Us Replacement: In the form settings, enable "Use as Contact Form" to replace the default form on the contact page. For registration, create a dedicated CMS page instead.
• Layout XML: Reference the form in your theme's layout XML to embed it on the customer registration page. See our embedding guide for all five methods.

Step 6: Set Up Email Notifications

Configure who receives registration notifications in the form's Email Settings tab. WebForms supports multiple recipients, CC/BCC, and different email templates per form. You can route registrations to different departments based on field values — for example, send wholesale applications to the sales team and retail signups to customer support.

B2B and wholesale stores often need a registration process that goes beyond collecting information. Typical requirements include:

• Manual approval: New wholesale accounts should not be active immediately (unlike a simple contact form). The sales team reviews the application, verifies the business license, and manually approves the account.
• Customer group assignment: Route approved dealers to a "Wholesale" customer group with tiered pricing automatically.
• Document collection: Require business license, resale certificate, or tax exemption documents as file uploads during registration.
• Conditional fields: Show different fields based on business type — a distributor sees quantity commitments, a retailer sees store location fields. (Suite only)

The Customer Registration add-on (included in WebForms Suite) connects form submissions directly to Magento's customer accounts. When a prospect submits the registration form, Suite automatically creates a customer account, assigns it to a customer group, and maps form fields to customer attributes — all without custom code.

Which version do you need? It depends on your registration requirements:

• The default Magento 2 registration form only has 5 fixed fields — customizing it requires PHP development.
• MageMe WebForms Suite lets you build custom registration forms from admin — no PHP coding needed.
• WebForms Lite (free) is great for contact forms, surveys, and inquiries. Customer registration requires WebForms Suite.
• WebForms Suite adds the Customer Registration add-on: auto-account creation, customer group assignment, conditional logic, and CRM integrations.
• All CAPTCHA methods (reCAPTCHA, hCaptcha, Turnstile) are supported in both Lite and Suite to prevent bot registrations.

Frequently Asked Questions