Use Social Login, Passkeys, Magic Link, and Email OTP across supported WooCommerce customer authentication flows.
VentraConnect Pro extends all four VentraConnect authentication methods into supported WooCommerce login and customer account flows.
The WooCommerce integration lets you place these methods on supported WooCommerce authentication surfaces while keeping account creation aligned with the intended customer journey.
Before You Start
Make sure:
- WooCommerce is installed and active.
- VentraConnect Free 1.4.7 or newer and VentraConnect Pro 1.4.4 or newer are installed and active.
- The authentication methods you want to use are already configured in VentraConnect.
- Your Social Login providers are configured and tested before enabling WooCommerce placement.
- For Passkeys: PHP 8.2 or higher (with the json, openssl and mbstring extensions) and HTTPS, which browsers require for passkeys.
Placement does not configure the authentication method itself. WooCommerce placement controls where already-configured VentraConnect methods appear.
Enable the WooCommerce Integration
In VentraConnect:
- Go to VentraConnect → WooCommerce.
- Turn on Show VentraConnect sign-in on WooCommerce pages. It is off by default; while it is off, nothing is added to WooCommerce pages.
- Choose the placements you want to use (see the next section).
- Click Save.
This is the master switch on the VentraConnect → WooCommerce tab. It is shown here in its default off position.
Once the switch is on, VentraConnect adds the authentication methods you have enabled to the placements you chose.
Placement and account eligibility are separate. Showing a login method on a WooCommerce surface does not by itself decide whether that surface may create a new WordPress account. See sections 5 and 6.
Choose WooCommerce Placements
The WooCommerce tab offers these placements:
There is no cart placement setting.
The login and registration placement options:
Classic checkout only. VentraConnect checkout placements work with the classic checkout (the [woocommerce_checkout] shortcode). The WooCommerce Checkout block and Cart block are not supported: nothing is added to a block-based checkout, and VentraConnect shows a warning in its WooCommerce settings. If your checkout page uses the Checkout block, switch it to the classic shortcode to use checkout placements. My Account placements are not affected.
Authentication Methods Available in WooCommerce
Password Phaseout is separate. Password Phaseout controls how strongly your site moves existing users away from passwords. It is not where Magic Link or Email OTP are enabled.
WooCommerce My Account & Customer Login
The My Account login form lets customers sign in with Social Login, Passkeys, Magic Link, or Email OTP when those methods are enabled and placed on the form.
New accounts on the WooCommerce login form are controlled by Allow new accounts from the WooCommerce login form (VentraConnect → WooCommerce). It is on by default, so out of the box a new visitor can create an account from this form, whatever WooCommerce’s own My Account registration setting says. Turn it off to keep the form for existing customers only.
To keep My Account for existing customers only, turn off Allow new accounts from the WooCommerce login form and let new customers register through the My Account registration form or checkout.
WooCommerce Checkout
Checkout is different from a normal login form because it is an intentional WooCommerce account-creation flow, and it is controlled by WooCommerce’s own checkout setting.
The classic checkout and Account details placement options:
Existing customers can authenticate during checkout when the relevant placement is enabled.
Classic checkout only. VentraConnect checkout placements work with the classic checkout (the [woocommerce_checkout] shortcode). The WooCommerce Checkout block and Cart block are not supported: nothing is added to a block-based checkout, and VentraConnect shows a warning in its WooCommerce settings. If your checkout page uses the Checkout block, switch it to the classic shortcode to use checkout placements. My Account placements are not affected.
Test checkout separately from My Account. They are different customer journeys with different account-creation rules.
Account Matching & Existing Customers
The goal is to authenticate the correct existing customer without creating unnecessary duplicate customer accounts.
Test the WooCommerce Integration
Recommended test:
- Open a private or incognito browser window.
- Visit the WooCommerce My Account page.
- Confirm the expected VentraConnect methods appear in the configured positions.
- Test login with an existing customer account.
- Add a product to the cart and continue to Checkout (confirm the page uses the classic checkout, not the Checkout block).
- Confirm the expected authentication options appear where enabled.
- Test an existing-customer checkout login.
- Test a completely new customer separately.
- Confirm checkout account creation follows WooCommerce’s Allow customers to create an account during checkout setting.
- Verify the customer lands on the expected page after authentication.
If Authentication Methods Do Not Appear
- Confirm VentraConnect Pro is active.
- Confirm Show VentraConnect sign-in on WooCommerce pages is on (VentraConnect → WooCommerce). It is off by default.
- Confirm the authentication method itself is enabled and configured.
- Confirm the relevant WooCommerce placement is selected.
- Check which checkout you use: placements appear only on the classic checkout (
[woocommerce_checkout]shortcode). The Checkout block and Cart block are not supported. - Clear page, browser, CDN, and WooCommerce-related caches.
- Test while fully logged out in an incognito window.
- Check whether your theme or WooCommerce template overrides replace the normal login or checkout markup.
- Run the site diagnostics in VentraConnect → Settings → Diagnostics & Tools when the provider or authentication flow itself fails.
