{"id":3043,"date":"2025-12-27T21:04:11","date_gmt":"2025-12-27T21:04:11","guid":{"rendered":"https:\/\/www.swiftcommerce.io\/help\/?post_type=docs&p=3043"},"modified":"2026-11-07T11:43:47","modified_gmt":"2026-11-07T11:43:47","password":"","slug":"registration-forms","status":"publish","type":"docs","link":"https:\/\/www.swiftcommerce.io\/help\/customization\/registration-forms\/","title":{"rendered":"Edit Registration Forms"},"content":{"rendered":"

Registration Form: standalone feature deprecated.<\/strong> Email Verification and Registration Form are now combined in Registration & Access<\/strong>. The functionality remains available; its settings now live in one workspace. This page is retained for earlier versions. Open the current Registration & Access guide<\/a>.<\/p>\n<\/div><\/div>\n\n

Overview<\/h2>\n\n\n\n

The Registration Form<\/strong> 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.<\/p>\n\n\n\n

Getting Started<\/h2>\n\n\n\n
    \n
  1. Navigate to Swift Commerce<\/strong> in your WordPress admin menu<\/li>\n\n\n\n
  2. Click on Registration Form<\/strong> in the features list<\/li>\n\n\n\n
  3. Toggle the Enable<\/strong> switch to activate the feature<\/li>\n\n\n\n
  4. Configure your fields and settings<\/li>\n\n\n\n
  5. Click Save Changes<\/strong><\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    Feature Tabs<\/h2>\n\n\n\n

    Field Editor Tab<\/h3>\n\n\n\n

    The Field Editor is a drag-and-drop interface for managing registration form fields.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Core Fields (Built-in)<\/h4>\n\n\n\n

    These fields are pre-configured and cannot be deleted:<\/p>\n\n\n\n

    Field<\/th>Description<\/th>Notes<\/th><\/tr><\/thead>
    Username<\/strong><\/td>User’s login name<\/td>Required, minimum 3 characters<\/td><\/tr>
    Email Address<\/strong><\/td>User’s email<\/td>Required, validated for format<\/td><\/tr>
    First Name<\/strong><\/td>User’s first name<\/td>Optional by default<\/td><\/tr>
    Last Name<\/strong><\/td>User’s last name<\/td>Optional by default<\/td><\/tr>
    Password<\/strong><\/td>User’s password<\/td>Handled by Email Verification feature when enabled<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Adding Custom Fields<\/h4>\n\n\n\n
      \n
    1. Click the + Add Field<\/strong> button<\/li>\n\n\n\n
    2. Choose a field type from the dialog:<\/li>\n<\/ol>\n\n\n\n

      Text Fields:<\/strong><\/p>\n\n\n\n

        \n
      • Text Input<\/li>\n\n\n\n
      • Email<\/li>\n\n\n\n
      • Password<\/li>\n\n\n\n
      • Phone Number<\/li>\n\n\n\n
      • URL<\/li>\n\n\n\n
      • Number<\/li>\n<\/ul>\n\n\n\n

        Selection Fields:<\/strong><\/p>\n\n\n\n

          \n
        • Dropdown Select<\/li>\n\n\n\n
        • Multi-Select<\/li>\n\n\n\n
        • Radio Buttons<\/li>\n\n\n\n
        • Checkboxes<\/li>\n\n\n\n
        • Single Checkbox<\/li>\n<\/ul>\n\n\n\n

          Date Fields:<\/strong><\/p>\n\n\n\n

            \n
          • Date Picker<\/li>\n\n\n\n
          • Date & Time<\/li>\n<\/ul>\n\n\n\n

            Advanced Fields (Pro):<\/strong><\/p>\n\n\n\n

              \n
            • File Upload<\/li>\n\n\n\n
            • Hidden Field<\/li>\n\n\n\n
            • Heading<\/li>\n\n\n\n
            • Paragraph<\/li>\n\n\n\n
            • Divider<\/li>\n<\/ul>\n\n\n\n
                \n
              1. Configure the field properties:\n
                  \n
                • Label<\/strong> \u2013 Display text above the field<\/li>\n\n\n\n
                • Placeholder<\/strong> \u2013 Hint text inside the field<\/li>\n\n\n\n
                • Description<\/strong> \u2013 Help text below the field<\/li>\n\n\n\n
                • Width<\/strong> \u2013 Full width or half width<\/li>\n\n\n\n
                • Required<\/strong> \u2013 Whether the field must be filled<\/li>\n\n\n\n
                • Validation<\/strong> \u2013 Min\/max length, pattern, etc.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n

                  Managing Fields<\/h4>\n\n\n\n
                    \n
                  • Drag to reorder<\/strong> \u2013 Click and hold the grip icon to rearrange fields<\/li>\n\n\n\n
                  • Edit<\/strong> \u2013 Click the pencil icon to modify field properties<\/li>\n\n\n\n
                  • Duplicate<\/strong> \u2013 Click the copy icon to create a copy of the field<\/li>\n\n\n\n
                  • Toggle<\/strong> \u2013 Use the switch to enable\/disable a field<\/li>\n\n\n\n
                  • Delete<\/strong> \u2013 Click the trash icon to remove a custom field (core fields cannot be deleted)<\/li>\n<\/ul>\n\n\n\n

                    Field Visibility (showOn)<\/h4>\n\n\n\n

                    Control where each field appears:<\/p>\n\n\n\n

                      \n
                    • WordPress<\/strong> \u2013 Standard \/wp-login.php?action=register form<\/li>\n\n\n\n
                    • WooCommerce<\/strong> \u2013 My Account registration form (Pro)<\/li>\n\n\n\n
                    • Checkout<\/strong> \u2013 During checkout registration (Pro)<\/li>\n\n\n\n
                    • My Account<\/strong> \u2013 Account details edit page (Pro)<\/li>\n<\/ul>\n\n\n\n
                      \n\n\n\n

                      Settings Tab<\/h3>\n\n\n\n

                      Form Context<\/h4>\n\n\n\n

                      Choose where your custom registration form applies:<\/p>\n\n\n\n

                      Setting<\/th>Free<\/th>Pro<\/th>Description<\/th><\/tr><\/thead>
                      WordPress Registration<\/td>\u2705<\/td>\u2705<\/td>Standard WP registration at \/wp-login.php?action=register<\/td><\/tr>
                      WooCommerce My Account<\/td>\u274c<\/td>\u2705<\/td>Registration on WooCommerce My Account page<\/td><\/tr>
                      Checkout Registration<\/td>\u274c<\/td>\u2705<\/td>Fields during guest checkout with account creation<\/td><\/tr>
                      My Account Edit<\/td>\u274c<\/td>\u2705<\/td>Allow users to edit custom fields in their account<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      Display Settings<\/h4>\n\n\n\n

                      Customize how the form looks:<\/p>\n\n\n\n

                      Setting<\/th>Options<\/th>Description<\/th><\/tr><\/thead>
                      Show Labels<\/td>On\/Off<\/td>Display field labels<\/td><\/tr>
                      Show Placeholders<\/td>On\/Off<\/td>Display placeholder text<\/td><\/tr>
                      Show Descriptions<\/td>On\/Off<\/td>Display help text<\/td><\/tr>
                      Required Indicator<\/td>* \/ (required) \/ custom<\/td>Symbol for required fields<\/td><\/tr>
                      Indicator Position<\/td>Before \/ After label<\/td>Where the indicator appears<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      Layout Settings<\/h4>\n\n\n\n
                      Setting<\/th>Options<\/th>Description<\/th><\/tr><\/thead>
                      Layout Style<\/td>Stacked \/ Inline<\/td>Vertical or horizontal arrangement<\/td><\/tr>
                      Columns Count<\/td>1 \/ 2<\/td>Multi-column layout<\/td><\/tr>
                      Field Spacing<\/td>Compact \/ Normal \/ Relaxed<\/td>Space between fields<\/td><\/tr>
                      Label Position<\/td>Above \/ Beside<\/td>Label placement relative to input<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                      \n\n\n\n

                      Pro Features<\/h2>\n\n\n\n

                      With Swift Commerce Pro<\/strong>, you unlock additional capabilities:<\/p>\n\n\n\n

                      WooCommerce Integration<\/h3>\n\n\n\n
                        \n
                      • My Account Registration<\/strong> \u2013 Custom fields on the WooCommerce My Account registration form<\/li>\n\n\n\n
                      • Checkout Registration<\/strong> \u2013 Add fields when customers create an account during checkout<\/li>\n\n\n\n
                      • Account Edit<\/strong> \u2013 Let customers edit custom field values in My Account<\/li>\n<\/ul>\n\n\n\n

                        Behavior Settings<\/h3>\n\n\n\n
                        Setting<\/th>Description<\/th><\/tr><\/thead>
                        Redirect After Registration<\/strong><\/td>Choose where users go after registering (default, My Account, custom page, custom URL)<\/td><\/tr>
                        Auto-Login<\/strong><\/td>Automatically log users in after registration<\/td><\/tr>
                        Send Welcome Email<\/strong><\/td>Send a customized welcome email to new registrants<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                        File Uploads<\/h3>\n\n\n\n

                        Allow users to upload files during registration:<\/p>\n\n\n\n

                          \n
                        • Profile pictures<\/li>\n\n\n\n
                        • ID documents<\/li>\n\n\n\n
                        • Business licenses<\/li>\n\n\n\n
                        • Any file type you specify<\/li>\n<\/ul>\n\n\n\n

                          Settings:<\/strong><\/p>\n\n\n\n

                            \n
                          • Maximum file size (MB)<\/li>\n\n\n\n
                          • Allowed file types (jpg, png, pdf, etc.)<\/li>\n<\/ul>\n\n\n\n
                            \n\n\n\n

                            Field Types Reference<\/h2>\n\n\n\n

                            Text Fields<\/h3>\n\n\n\n
                            Type<\/th>Icon<\/th>Use Case<\/th><\/tr><\/thead>
                            Text<\/td>Aa<\/td>Names, company, custom text<\/td><\/tr>
                            Email<\/td>\u2709<\/td>Email addresses with validation<\/td><\/tr>
                            Password<\/td>\ud83d\udd12<\/td>Secure password input<\/td><\/tr>
                            Phone<\/td>\ud83d\udcde<\/td>Phone numbers<\/td><\/tr>
                            URL<\/td>\ud83d\udd17<\/td>Website addresses<\/td><\/tr>
                            Number<\/td>#<\/td>Numeric values<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                            Selection Fields<\/h3>\n\n\n\n
                            Type<\/th>Icon<\/th>Use Case<\/th><\/tr><\/thead>
                            Dropdown<\/td>\u25bc<\/td>Single selection from list<\/td><\/tr>
                            Multi-Select<\/td>\u2611\u2611<\/td>Multiple selections from list<\/td><\/tr>
                            Radio<\/td>\u25c9<\/td>Single choice, all options visible<\/td><\/tr>
                            Checkboxes<\/td>\u2611<\/td>Multiple choices, all visible<\/td><\/tr>
                            Single Checkbox<\/td>\u2713<\/td>Terms acceptance, newsletter opt-in<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                            Date Fields<\/h3>\n\n\n\n
                            Type<\/th>Use Case<\/th><\/tr><\/thead>
                            Date Picker<\/td>Birthdate, start dates<\/td><\/tr>
                            Date & Time<\/td>Appointments, events<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                            Advanced Fields (Pro)<\/h3>\n\n\n\n
                            Type<\/th>Use Case<\/th><\/tr><\/thead>
                            File Upload<\/td>Documents, images<\/td><\/tr>
                            Hidden<\/td>Store hidden values<\/td><\/tr>
                            Heading<\/td>Section titles<\/td><\/tr>
                            Paragraph<\/td>Informational text<\/td><\/tr>
                            Divider<\/td>Visual separation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                            \n\n\n\n

                            Validation Options<\/h2>\n\n\n\n

                            Each field supports these validation rules:<\/p>\n\n\n\n

                            Rule<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
                            Required<\/td>Field must be filled<\/td>\u2713<\/td><\/tr>
                            Min Length<\/td>Minimum characters<\/td>3<\/td><\/tr>
                            Max Length<\/td>Maximum characters<\/td>50<\/td><\/tr>
                            Pattern<\/td>Regex pattern<\/td>^[A-Z]{2}[0-9]{6}$<\/td><\/tr>
                            Min Value<\/td>Minimum number (for number fields)<\/td>18<\/td><\/tr>
                            Max Value<\/td>Maximum number<\/td>120<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                            \n\n\n\n

                            Integration with Email Verification<\/h2>\n\n\n\n

                            When the Email Verification<\/strong> feature is enabled:<\/p>\n\n\n\n

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

                              This ensures a seamless experience without duplicate password fields.<\/p>\n\n\n

                              Emails tab<\/h2>

                              The current dashboard includes an Emails<\/strong> tab. Turn Welcome Email<\/strong> on or off there. It is sent after successful registration. Pro adds Customize Email<\/strong>, which opens the shared email editor for subject, heading, body, preheader, additional content, branding preview, and a test send. Keep useful placeholders such as {{user_name}}<\/code>, {{user_login}}<\/code>, {{site_name}}<\/code>, and {{login_link}}<\/code> in the message where relevant. Save the email editor and the feature settings, then test a registration.<\/p>

                              More Settings controls<\/h2>

                              CAPTCHA Protection<\/strong> lets you require the Swift Commerce CAPTCHA feature on the registration forms you configure. Set up and test the CAPTCHA provider separately before turning this on. Role Assignment<\/strong> (Pro) assigns a default role and can apply field-based rules to assign a role when a selected field, condition, and value match. These rules affect account permissions: use only roles appropriate for public sign-up, and test a new account after changes.<\/p>

                              Display Settings choose where the form appears; Layout Settings control the form layout, columns, spacing, and label position; Behavior Settings control the post-registration destination. Verify each enabled WordPress and WooCommerce surface rather than assuming one setting applies to every form.<\/p>

                              Final checks<\/h2>
                              • Register on each enabled surface and confirm field order, required-field validation, account role, welcome email, and redirect.<\/li>
                              • If Email Verification is also enabled for the same surface, choose which feature controls fields in Email Verification \u2192 Settings. Test the password and verification\/approval flow together.<\/li>
                              • For file-upload fields, verify allowed file types, size limits, and the resulting account data before making the form public.<\/li><\/ul>\n\n\n