SSP Documentation
Overview
SSP Checkout Field Editor Pro gives you complete control over WooCommerce checkout fields. Manage billing, shipping, account, and additional fields with drag-and-drop reordering, custom field creation, and flexible account registration options.
| Admin Location | WooCommerce → Checkout Fields |
|---|---|
| Shortcode | (classic checkout) |
| Requirements | WooCommerce 6.0+, WordPress 5.8+, PHP 7.4+ |
Field Management
The admin interface is organized into tabs: Billing, Shipping, Additional/Custom, Settings, and Instructions. Each field section has Active and Disabled areas.
Active vs Disabled Fields
- Active Fields — Displayed on checkout. Drag to reorder.
- Disabled Fields — Hidden from checkout but preserved for later use.
Field Actions
- Drag Handle (☰) — Reorder fields within the active section.
- Edit — Open modal to change label, type, placeholder, CSS class, options.
- Enable/Disable — Move field between active and disabled sections.
- Delete — Permanently remove custom fields (default fields cannot be deleted).
- Required Toggle — Quick toggle for required status directly in the table.
Field Badges
| DEFAULT | Standard WooCommerce fields. Cannot be deleted, but can be disabled or customized. |
|---|---|
| ACCOUNT | Account creation fields (username, password, confirm password). Only shown to guests. |
| CUSTOM | Your custom fields. Can be deleted at any time. |
Field Types
Choose from 11 field types when creating or editing fields.
| Text | Single-line text input. |
|---|---|
| Textarea | Multi-line text area for longer responses. |
| Select/Dropdown | Dropdown menu with predefined options. |
| Checkbox | Single checkbox for yes/no choices. |
| Radio Buttons | Multiple choice with radio buttons. |
| Email input with validation. | |
| Phone | Telephone number input. |
| Number | Numeric input only. |
| Date Picker | Date selection calendar. |
| Password | Masked password input. |
| Section Heading | Non-input heading to organize form sections. |
Field Properties
- Label — Field label displayed to customers.
- Placeholder — Hint text inside the input.
- CSS Class — Layout class:
form-row-wide,form-row-first,form-row-last. - Options — For select/radio fields, format:
value1|Label 1(one per line). - Required — Whether the field must be filled.
Custom Fields
Add your own fields to collect additional information from customers.
Adding a Custom Field
- Go to the Additional / Custom tab.
- Click Add Custom Field button.
- Enter a Field Name (letters, numbers, underscores only).
- Enter a Label and choose a Type.
- Set placeholder, CSS class, and required status.
- Click Add Field.
| Storage | Custom fields save to order meta as _fieldname and display in admin, emails, and order confirmations. |
|---|---|
| Validation | Required custom fields are validated at checkout. |
| Display | Custom fields appear after Order Notes on the checkout form. |
Account Creation Fields
Allow customers to create accounts during checkout with customizable registration fields.
Available Account Fields
| Email (Account Login) | The billing email becomes the account login. Always in Billing section. |
|---|---|
| Account Username | Let customers choose their username. If not enabled, username is generated from email. |
| Account Password | Let customers set their own password. |
| Confirm Password | Password confirmation with real-time matching indicator. |
How It Works
- Account fields only appear for guest users (not logged-in customers).
- Enable any account field in the Billing tab to activate account creation.
- Password strength indicator shows weak/medium/strong as customer types.
- Password mismatch shows red border; match shows green border.
- Customer is logged in immediately after order completion.
Layout Settings
Configure how field tabs are organized in the admin interface.
Single Form Mode
- Combines ALL fields (billing, shipping, additional) into one unified tab.
- Simplifies management when you have many custom fields.
- Hides the “Ship to different address” checkbox on checkout.
Combine Billing & Shipping
- Merges billing and shipping fields into one tab.
- Keeps Additional/Custom fields in a separate tab.
- Also hides the “Ship to different address” checkbox.
Auto-Generated Passwords
Enable automatic account creation with system-generated passwords.
How to Enable
- Go to the Settings tab.
- Enable Email Auto-Generated Passwords.
- Save changes.
Behavior When Enabled
- Forces account creation for all guest customers.
- Email field becomes locked — always required, cannot be disabled.
- Password fields become optional — customer can set their own or leave blank.
- If password is blank, a secure 12-character password is auto-generated.
- Generated password is emailed to customer with login details.
| Email Subject | [Site Name] Your Account Password |
|---|---|
| Email Contents | Username, generated password, and login link. |
Compatibility
This plugin works with the Classic WooCommerce Checkout (shortcode-based) only.
Setting Up Classic Checkout
- Go to Pages → Checkout in WordPress admin.
- Delete any existing Block checkout content.
- Add a Shortcode block (or use Classic Editor).
- Paste:
- Save/Update the page.
Technical Compatibility
| WooCommerce HPOS | Fully compatible with High-Performance Order Storage. |
|---|---|
| Page Builders | Works with Elementor, Divi, Beaver Builder — use Shortcode widget. |
| Themes | Compatible with any theme using standard WooCommerce hooks. |
FAQ & Troubleshooting
Fields not showing on checkout?
- Ensure you’re using classic shortcode checkout, not blocks.
- Check the field is in “Active Fields”, not “Disabled”.
- Clear caching plugins after changes.
Account fields not appearing?
- Account fields only show for guest users.
- Log out to test, or use incognito window.
- Ensure at least one account field is enabled.
Custom field not saving?
- Confirm the field is enabled (Active section).
- Check order meta for
_fieldnamein admin. - Field names cannot have spaces or special characters.
Password mismatch not showing?
- Both Password and Confirm Password must be enabled.
- Check browser console for JavaScript errors.
- Ensure jQuery is loading properly.
How do I reset everything?
Click Reset to Defaults at the bottom of the admin page. This will restore all fields to their original WooCommerce defaults and clear all settings.
Where are custom field values stored?
Custom fields are saved as order meta with an underscore prefix (e.g., _my_custom_field). They display automatically in the admin order details, customer order confirmation, and order emails.