Registration Forms

Overview #

The Registration Form feature in Swift Commerce allows you to fully customize WordPress and WooCommerce registration forms with custom fields, validation rules, and display options. Instead of using multiple plugins for form customization, you get one unified solution.

Getting Started #

1. Navigate to Swift Commerce in your WordPress admin menu
2. Click on Registration Form in the features list
3. Toggle the Enable switch to activate the feature
4. Configure your fields and settings
5. Click Save Changes

---

Feature Tabs #

Field Editor Tab

The Field Editor is a drag-and-drop interface for managing registration form fields.

Core Fields (Built-in)

These fields are pre-configured and cannot be deleted:

Field	Description	Notes
Username	User’s login name	Required, minimum 3 characters
Email Address	User’s email	Required, validated for format
First Name	User’s first name	Optional by default
Last Name	User’s last name	Optional by default
Password	User’s password	Handled by Email Verification feature when enabled

Adding Custom Fields

1. Click the + Add Field button
2. Choose a field type from the dialog:

Text Fields:

• Text Input
• Email
• Password
• Phone Number
• URL
• Number

Selection Fields:

• Dropdown Select
• Multi-Select
• Radio Buttons
• Checkboxes
• Single Checkbox

Date Fields:

• Date Picker
• Date & Time

Advanced Fields (Pro):

• File Upload
• Hidden Field
• Heading
• Paragraph
• Divider

3. Configure the field properties:
   • Label – Display text above the field
   • Placeholder – Hint text inside the field
   • Description – Help text below the field
   • Width – Full width or half width
   • Required – Whether the field must be filled
   • Validation – Min/max length, pattern, etc.

Managing Fields

• Drag to reorder – Click and hold the grip icon to rearrange fields
• Edit – Click the pencil icon to modify field properties
• Duplicate – Click the copy icon to create a copy of the field
• Toggle – Use the switch to enable/disable a field
• Delete – Click the trash icon to remove a custom field (core fields cannot be deleted)

Field Visibility (showOn)

Control where each field appears:

• WordPress – Standard /wp-login.php?action=register form
• WooCommerce – My Account registration form (Pro)
• Checkout – During checkout registration (Pro)
• My Account – Account details edit page (Pro)

---

Settings Tab

Form Context

Choose where your custom registration form applies:

Setting	Free	Pro	Description
WordPress Registration	✅	✅	Standard WP registration at /wp-login.php?action=register
WooCommerce My Account	❌	✅	Registration on WooCommerce My Account page
Checkout Registration	❌	✅	Fields during guest checkout with account creation
My Account Edit	❌	✅	Allow users to edit custom fields in their account

Display Settings

Customize how the form looks:

Setting	Options	Description
Show Labels	On/Off	Display field labels
Show Placeholders	On/Off	Display placeholder text
Show Descriptions	On/Off	Display help text
Required Indicator	* / (required) / custom	Symbol for required fields
Indicator Position	Before / After label	Where the indicator appears

Layout Settings

Setting	Options	Description
Layout Style	Stacked / Inline	Vertical or horizontal arrangement
Columns Count	1 / 2	Multi-column layout
Field Spacing	Compact / Normal / Relaxed	Space between fields
Label Position	Above / Beside	Label placement relative to input

Custom CSS

Add custom CSS to style your registration form. This CSS is loaded on the login/registration page.

---

Pro Features #

With Swift Commerce Pro, you unlock additional capabilities:

WooCommerce Integration

• My Account Registration – Custom fields on the WooCommerce My Account registration form
• Checkout Registration – Add fields when customers create an account during checkout
• Account Edit – Let customers edit custom field values in My Account

Behavior Settings

Setting	Description
Redirect After Registration	Choose where users go after registering (default, My Account, custom page, custom URL)
Auto-Login	Automatically log users in after registration
Send Welcome Email	Send a customized welcome email to new registrants

File Uploads

Allow users to upload files during registration:

• Profile pictures
• ID documents
• Business licenses
• Any file type you specify

Settings:

• Maximum file size (MB)
• Allowed file types (jpg, png, pdf, etc.)

---

Field Types Reference #

Text Fields

Type	Icon	Use Case
Text	Aa	Names, company, custom text
Email	✉	Email addresses with validation
Password	🔒	Secure password input
Phone	📞	Phone numbers
URL	🔗	Website addresses
Number	#	Numeric values

Selection Fields

Type	Icon	Use Case
Dropdown	▼	Single selection from list
Multi-Select	☑☑	Multiple selections from list
Radio	◉	Single choice, all options visible
Checkboxes	☑	Multiple choices, all visible
Single Checkbox	✓	Terms acceptance, newsletter opt-in

Date Fields

Type	Use Case
Date Picker	Birthdate, start dates
Date & Time	Appointments, events

Advanced Fields (Pro)

Type	Use Case
File Upload	Documents, images
Hidden	Store hidden values
Heading	Section titles
Paragraph	Informational text
Divider	Visual separation

---

Validation Options #

Each field supports these validation rules:

Rule	Description	Example
Required	Field must be filled	✓
Min Length	Minimum characters	3
Max Length	Maximum characters	50
Pattern	Regex pattern	^[A-Z]{2}[0-9]{6}$
Min Value	Minimum number (for number fields)	18
Max Value	Maximum number	120

---

Integration with Email Verification #

When the Email Verification feature is enabled:

1. Password fields are automatically handled by Email Verification
2. Users set their own password during registration
3. Core password fields are skipped in Registration Form to prevent duplication
4. Verification email is sent after registration

This ensures a seamless experience without duplicate password fields.