Contact Details
The Contact Details tab lets you add an optional step to the configurator wizard that collects customer email and phone number before they reach checkout. This serves two purposes:
- Abandoned cart recovery — if a customer completes the wizard but abandons checkout, their email and phone are already captured for follow-up
- Express payment compatibility — Google Pay and Apple Pay don’t always transmit phone numbers reliably, so capturing it in the wizard ensures you have it
How It Works
Section titled “How It Works”When enabled, a “Contact Details” step appears as the last step in the wizard, just before Add to Cart. Customers enter their email and phone number, which are then:
- Saved to the WooCommerce session — abandoned cart recovery tools (Klaviyo, Mailchimp, AutomateWoo, Omnisend, Metorik, CartFlows) automatically detect the
billing_emailin the session and can trigger recovery flows - Prefilled at checkout — the billing email and phone fields are pre-populated, reducing friction
- Stored with the order — contact details are saved as part of the lens configuration data
Settings
Section titled “Settings”Enable for Prescription Orders
Section titled “Enable for Prescription Orders”Toggle the contact details step on or off for orders that include a prescription (manual entry, upload, or send later).
- Default: Disabled
- When to enable: If you want to capture contact details for abandoned cart recovery or to ensure phone numbers are collected for lab communication
Enable for Non-Prescription Orders
Section titled “Enable for Non-Prescription Orders”When the main toggle is enabled, this additional toggle controls whether the contact details step also appears for non-prescription orders (e.g. fashion frames, plano lenses).
- Default: Disabled
- When to enable: If you want to capture contact details for all orders, not just prescription ones
Require Email Address
Section titled “Require Email Address”Whether the email field is mandatory when the contact details step is shown.
- Default: Enabled
Require Phone Number
Section titled “Require Phone Number”Whether the phone field is mandatory when the contact details step is shown.
- Default: Enabled
Wizard Flow
Section titled “Wizard Flow”When enabled, the wizard steps become:
Prescription orders:
- Lens Usage
- Varifocal Type (conditional)
- Lens Colour
- Lens Package
- Prescription
- Contact Details
- Add to Cart
Non-prescription orders (if enabled):
- Lens Usage
- Lens Colour
- Lens Package
- Contact Details
- Add to Cart
When disabled, the wizard flow remains unchanged.
Integration Hooks
Section titled “Integration Hooks”PHP Action Hook
Section titled “PHP Action Hook”do_action( 'speccart_contact_details_captured', $email, $phone, $session_id );Fires when contact details are saved during add-to-cart. Use this to integrate with CRMs, Zapier, or custom notification workflows.
Parameters:
$email(string) — Customer email address$phone(string) — Customer phone number$session_id(string) — WooCommerce session customer ID
JavaScript Event
Section titled “JavaScript Event”window.addEventListener('speccart:contact_captured', (event) => { const { email, phone } = event.detail; // Push to Google Tag Manager, Meta Pixel, etc.});Fires on the client side when the contact details step is completed. Use this for analytics tracking, retargeting pixels, or other client-side integrations.
Export/Import
Section titled “Export/Import”Contact details settings are included in the SpecCart export file and restored on import. If importing an older export file that predates this feature, the defaults (disabled) are used.