Register module
Purpose and when to use
The Register module lets new users create an account and subscribe to a membership plan in one step. Use it when you want a single form for both registration and payment. For existing users who already have an account but no subscription, use the Signup module instead.
- Order summary — The form can show an order summary with plan, price, and optional coupon. When only one plan and one billing cycle exist, the plan dropdown can be hidden and the order summary shown immediately.
- Coupons — Users can enter a coupon code; discounts apply per your coupon settings (percentage/fixed, plan restrictions). Coupons persist in the browser when switching plans.
- Free trials — If the selected plan has a free trial (configured in Settings > Free Trials), the form reflects trial duration and whether payment is required upfront.
- Stripe v3 — Payment uses Stripe Elements by default (multiple payment methods). Billing address fields appear only when Stripe Legacy (v2) is enabled in Settings > Payment Gateways.
Compatibility and performance notes
- Divi: Current Divi version with Divi Membership 2.0.x or later.
- Payment gateways: Stripe (v3 or Legacy) and PayPal; configure in Settings > Payment Gateways.
- Spam protection: Configure reCAPTCHA keys in Settings > Spam.
Add to page
- In the Divi Builder, add a new module and choose Register (under Divi Membership).
- Set Form Title and User Role for new registrants.
- Under Layout Options, enable Enable Payment Form if the membership requires payment.
- Configure Redirect Type and Redirect Page/URL for after registration.
- Optionally enable Order summary and coupon field; set plan display (intro text, plan title, optgroups, exclude plans by ID) as needed.
- Save and test: register as a new user and confirm redirect and payment flow.
Settings
| Setting | Type | Default | Depends On | Notes |
|---|---|---|---|---|
| Form Title | text | — | — | Title above the form. |
| User Role | select | subscriber | — | Role assigned to new users. |
| Auto Login & Redirect | boolean | — | — | Log user in after registration and redirect. |
| Redirect Type | select | page / custom URL | — | Where to send user after registration. |
| Redirect Page/URL | page / text | — | Redirect Type | Target page or URL. |
| Logged In Action | select | message / layout / redirect | — | What to show when a logged-in user opens the form. |
| Form Title Visibility | boolean | — | — | Show or hide the form title. |
| Enable Payment Form | boolean | No | — | Show payment and plan selection; enables order summary and coupon when applicable. |
| Payment Selection Requirement | boolean | — | Enable Payment Form | Require payment method (e.g. Stripe) before submit. |
| Membership Plan Field Style | select | Select / Radio | Enable Payment Form | How plans are shown (dropdown or radio). |
| Plan intro / title / optgroups / exclude by ID | various | — | Enable Payment Form | Plan display options; exclude specific plan IDs. |
| Order summary | boolean | — | Enable Payment Form | Show order summary with plan and price; coupon support. |
| Single plan auto-select | — | — | One plan, one cycle | Dropdown hidden; order summary shown immediately. |
| Redirect (failed payment) | page / URL | — | Enable Payment Form | Where to send user if payment fails. |
| Show Billing Address Fields | boolean | No | Enable Payment Form | Shown only when Stripe Legacy (v2) is on in Settings > Payment Gateways; Stripe v3 uses Elements without billing address. |
| Company Field Visibility | boolean | — | Show Billing Address | Include company in billing. |
| Enable Field Label / Placeholder | boolean | — | — | Labels and placeholders on form fields. |
| Form Columns | select | 1 / 2 | — | Form layout. |
| Payment Design / Columns / Logos / Labels | various | — | Enable Payment Form | How payment options are displayed. |
| Honeypot Captcha | boolean | — | — | Basic bot protection. |
| Google reCAPTCHA | boolean | — | — | Requires keys in Settings > Spam. |
Examples and common patterns
- Single plan, one cycle: Use one plan with one billing cycle; the plan dropdown is hidden and the order summary appears so users go straight to payment.
- Free trial: In Settings > Free Trials set duration and “require payment upfront” for the cycle; the Register form shows trial terms and collects payment when required.
- Coupon on register: Enable the coupon field in the module; users enter a code and the order summary updates. Coupons that don’t apply to the selected plan show an error.
Pitfalls and limits
warning
If the form shows billing address fields, ensure Stripe Legacy (v2) is enabled in Settings > Payment Gateways. With Stripe v3 (default), billing address is not shown on the form.
- Spam: reCAPTCHA keys are set in Settings > Spam, not in the old “Membership Settings > General > Spam Protection” location.
- Plan display: Exclude plans by ID when you want to hide specific plans from the register form (e.g. internal or legacy plans).
Related links
- Signup module — For existing users subscribing to a plan.
- Settings > Payment Gateways — Stripe v3 vs Legacy, billing address.
- Settings > Free Trials — Trial duration and require payment.
What's Next
- Signup module — Subscribe existing users to a plan with order summary and coupons.
- Membership Item — Display plan details and a register button on pricing pages.
- Feature Overview — Plans, payments, trials, and account.