Accounts & Users · Module 3.16 v1.0.0

Custom B2B Registration

Build custom registration forms for wholesale buyers with a drag-and-drop field builder. Collect business information upfront, route new registrants through an approval workflow, and auto-assign roles when approved.

In plain terms: Instead of sending new wholesale buyers through the generic WooCommerce registration, you show them a form that asks "Company Name," "Business Type," "Tax ID," "Upload your resale certificate." When they submit, you get all the info you need to approve or reject them — and they get a "Pending Approval" holding role until you act.

Drag-and-Drop Form Builder

Build your registration form without code. Add, remove, and reorder fields: text, select, checkbox, file upload, textarea, date. Mark fields required or optional.

Approval Workflow

New registrants are assigned a "Pending Approval" role and held for review. You see all pending applications in a dedicated admin queue with their submitted data.

One-Click Approve/Reject

From the admin queue, review the application and click Approve (assigns the target wholesale role) or Reject (sends rejection email). Bulk approve/reject supported.

Auto-Role Assignment

Set which role approved registrants receive. Can vary by business type field — distributors get one role, retailers get another, automatically.

Notification Emails

Automatic emails on submission (to admin), approval (to buyer), and rejection (to buyer). All email templates are customisable.

Shortcode & Page Integration

Embed the form anywhere using [woob2b_registration_form]. Optionally replace the default WooCommerce My Account registration page automatically — no shortcode needed in that case.

Conditional Field Logic

Show or hide form fields based on other field values. For example: show the "Resale Certificate" upload only when "Business Type" is set to "Retailer." Logic rules are built visually — no code required.

Setup

Form Field Types

Field TypeUse forExample
TextCompany name, Tax ID, website"Company Name *"
Select / DropdownBusiness type, industry, country"Business Type: Retailer / Distributor / Wholesaler"
File UploadResale certificates, licences, documents"Upload your resale certificate (PDF, JPG)"
TextareaNotes, description, additional context"Tell us about your business"
CheckboxT&C acceptance, opt-ins"I agree to the wholesale terms and conditions"
NumberEstimated annual spend, headcount"Estimated monthly order value ($)"

Shortcode Reference

ShortcodeWhere to use itNotes
[woob2b_registration_form]Any page, post, or widget areaRenders the full B2B registration form. No attributes required. Only shown to logged-out users by default.
No shortcode needed for My Account. If you enable "Replace WooCommerce My Account Registration" in Registration Settings, your custom form automatically replaces the standard WooCommerce registration tab. The shortcode is for placing the form on standalone pages such as a dedicated "Apply for a wholesale account" landing page.

Conditional Field Logic

Each form field can have conditional display rules. A field is shown or hidden based on the value of another field in the same form. Rules are set in the Form Builder — no code required.

Condition typeWhat it doesExample
Show ifField is hidden by default and only appears when the condition is met.Show "Resale Certificate Upload" only when "Business Type" = "Retailer"
Hide ifField is visible by default and is hidden when the condition is met.Hide "Tax ID" when "Country" = "US"
Multiple conditionsChain AND/OR conditions. All or any must be true before the field shows.Show "Distributor Region" only when Business Type = "Distributor" AND Country = "US"
Conditional logic also applies to which role gets assigned on approval. If "Business Type" is "Distributor" the registrant can be auto-assigned the Distributor role; if it is "Retailer" they get the Retailer role — all from a single form with no manual admin sorting needed.

Good Combinations

Registration + Hide Price + User Roles

Guests see "Register for wholesale pricing." After registration they're Pending Approval — prices still hidden. After approval they're Wholesale Bronze — prices appear.

B2B RegistrationHide PriceUser Roles
Complete flow: Visit → Register → Pending (no prices) → Admin approves → Wholesale role → Full catalogue with pricing visible.

Registration + Tax Exempt

Collect the tax exemption certificate as part of the registration form — a File Upload field. Admin reviews both the business and the certificate together before approving.

B2B RegistrationTax Exempt
Result: One approval step covers both "can this buyer see our prices" and "should their orders be tax-free." No separate certificate submission needed later.

Use [woob2b_registration_form] — add it to any page or post. The form is automatically hidden for logged-in users. If you want to replace the standard WooCommerce My Account registration screen entirely, enable the "Replace WooCommerce My Account Registration" option in Settings → Registration Settings instead — no shortcode needed in that case.

Yes — this is conditional field logic. In the Form Builder, click any field and set a "Show if" or "Hide if" rule targeting another field's value. For example: show "Resale Certificate" only when "Business Type" equals "Retailer." Multiple AND/OR conditions are supported per field. Logic is evaluated in real time as the user fills in the form.

Yes. In Settings → Registration Settings, set "Approval Mode" to "Auto-Approve." Registrants go straight to the approved wholesale role without manual review. This is useful when you're not yet sure you need an approval gate, or for less restricted product lines. You can switch between manual and auto-approval at any time.

No. Existing users just need their B2B role assigned — either manually via the user edit screen, or in bulk via the User Roles admin. The registration form is only for new sign-ups. You can also import a CSV of existing customers and assign them roles in bulk.

Yes. Enable "Admin Email on New Registration" in Settings → Registration Settings. You'll receive an email for each new submission with a direct link to the admin review screen. You can also use the woob2b_registration_approved hook to trigger additional actions on approval — like awarding welcome points or creating a company account automatically.