If Magic Link or Email OTP emails aren’t arriving in your inbox, don’t panic. In most cases VentraConnect is working correctly and the issue is email delivery on the site (wp_mail), SMTP settings, or a small misconfiguration.
This guide walks you through everything to check before you contact support.
When This Guide Applies
Use this article if:
- Users click “Continue with Magic Link” or “Continue with OTP (Email)” and then “Send link” / “Send code” (inline Pro forms use “Send Magic Link” / “Send Code”)
- VentraConnect shows a success message (no error on the form)
- But no email arrives in their inbox
If you see an error message on the screen instead, see Troubleshooting Magic Link and Troubleshooting Email OTP (invalid email, throttling, max attempts, and more). Magic Link and OTP (Email) are both included in VentraConnect Free.
Confirm Magic Link / OTP Is Actually Enabled
First make sure the features themselves are turned on.
- Go to VentraConnect → Settings → Login Methods.
- Open the relevant method: Magic Link or OTP (Email).
- Check that the Active toggle is On, and that Code length / Expiry / Resend throttle and other options are set as you expect.
- Check Registration mode. With Login only (existing users), only existing accounts can sign in, so test with an email address that already belongs to a user.
If the method is Off, turn it On, save changes, and test again. While a method is off, the form shows “This sign-in method is currently unavailable.” and no emails are sent; Magic Links sent while it was off stop working.
Check That Buttons Are Visible on the Form
If users can’t see the Magic Link / OTP buttons, they obviously can’t trigger an email. Buttons are never shown to signed-in users, so test while logged out.
WordPress core login form
- Go to VentraConnect → Settings (the Settings tab).
- Under Show on WordPress login/register, confirm that the Login form toggle is on, and the Register form toggle too if you want it there. These apply to all active methods.
- Check that your button layout/theme settings look correct.
WooCommerce / membership / LMS / comments
- WooCommerce: VentraConnect → WooCommerce tab. Turn on Show VentraConnect sign-in on WooCommerce pages (off by default) and pick placements. Only the classic checkout ([woocommerce_checkout]) is supported, not the Checkout block.
- Memberships & communities: Community & Memberships tab
- Courses & LMS: Courses & LMS tab
- Comments: Comments tab
Make sure the integration is enabled, the relevant form placement is chosen for each form, and you can actually see the Magic Link / OTP buttons on the front-end form you’re testing. These integration placements need VentraConnect Pro.
If you don’t see the button at all, fix that before chasing email delivery.
Use the Built-in Test Tool
VentraConnect can send a test message directly from the settings page.
- Go to VentraConnect → Settings → Login Methods → Magic Link (or OTP (Email)).
- Click Send test email next to Save Changes. It is sent to the site admin email address; there is no field to enter a different address.
In the Magic Link pane, Send test email sits in the save bar next to Save Changes:
The OTP (Email) pane has the same button:
Now check the admin inbox:
- If the test email works, but real login/OTP emails don’t, skip ahead to “8. Check Throttling, Attempts, and Rate Limits”.
- If the test email also doesn’t arrive, continue with the hosting / SMTP checks below.
Test Your Site’s Email Using Another Plugin
We need to figure out if this is a global email problem or VentraConnect-only. You can also run Diagnostics & Tools → Run site diagnostics, which checks that wp_mail() is available.
- Install a simple contact form plugin (for example Contact Form 7 or WPForms Lite, anything lightweight).
- Create a basic form that sends an email to your own address.
- Submit the form.
Now compare:
- Scenario A: No emails from anything. Contact form emails don’t arrive and Magic Link / OTP test emails don’t arrive. Your site email (wp_mail) is broken or blocked. This is a hosting / SMTP issue, not a VentraConnect bug.
- Scenario B: Contact form emails work, VentraConnect does not. Move on to the next sections: this points to configuration, deliverability, or a plugin conflict.
Fix Basic Deliverability: Use a Proper SMTP Plugin
Most hosts are bad at sending PHP mail. Even if it “works”, messages often land in spam. For a production site you should always send via SMTP or an email service.
- Install a transactional email plugin (examples: WP Mail SMTP, FluentSMTP).
- Connect it to a real mail provider: your host’s SMTP, your domain email (for example via cPanel or a mail service), or a dedicated service like SendGrid, Mailgun, or Amazon SES.
- Use the SMTP plugin’s test email feature to ensure delivery works.
- Once this test succeeds, retest the Magic Link test email, the OTP test email, and real login / OTP flows from the front-end.
If SMTP test emails don’t work, fix that first. VentraConnect can’t send emails if wp_mail itself is failing. VentraConnect’s Email sender field only changes the From name; set the From address in your SMTP plugin.
Check Spam/Junk and “Promotions” Tabs
It is simple, but you will save yourself time by verifying this up front:
- Check the Spam/Junk folder of your test mailbox
- Check “Promotions” or “Updates” tabs (Gmail, etc.)
- Search your inbox for the subject line you configured in VentraConnect, and for the sender name / email
If messages are there but marked as spam:
- Set a clearer From name and From address in your SMTP plugin
- Use a real mailbox like
login@yourdomain.com, notno-reply@localhost - Avoid spammy subject lines or all-caps
Check Throttling, Attempts, and Rate Limits
Codes and links won’t be sent indefinitely if the user is hammering the form. Go to VentraConnect → Settings → Login Methods and check, for OTP (Email) (and Magic Link where shown):
Common mistakes:
- Setting a very low throttle in testing, then forgetting what you changed
- Setting Max attempts to 1 (the minimum), then wondering why a code stops working after a single mistake
- Hammering the form while testing and tripping the 10-minute verification pause
Try with a resend throttle of 30–60 seconds and Max attempts of 5. Save, then test again using a fresh browser session or private window.
Check Magic Link Expiry and Link Reuse
Each Magic Link works once and only until it expires. In the Magic Link settings:
- Make sure Expiry (minutes) (default 10) isn’t set to something tiny when you’re testing slowly.
- If a user clicks an old link or reuses the same link, they might be clicking an already-used or expired link.
- If Restrict Login from Same IP is on (off by default), the link has to be opened from the same IP address that requested it.
Requesting a new Magic Link does not cancel earlier unused links, so use the most recent email to avoid confusion. (For Email OTP, a new code does cancel the previous one.)
Good test setup: an expiry of 10–30 minutes for normal sites. If you’re testing many times, always use the most recent email.
Check for Plugin Conflicts or Custom Code
If everything above looks good and you still get nothing only for Magic Link / OTP:
- Temporarily disable security / firewall plugins (Wordfence, iThemes, etc.), login/redirect plugins that also modify wp-login.php, and aggressive caching plugins that might cache forms or AJAX responses.
- Clear caches (plugin + host + browser).
- Test again.
If the emails suddenly start working, re-enable plugins one at a time to find the culprit. For the conflicting plugin, you may need to:
- Exclude VentraConnect’s login/OTP routes from blocking
- Disable one of its overlapping features (for example a separate 2FA/OTP system)
- Add compatibility rules on your security plugin
Collect Diagnostics Before Contacting Support
If you’ve gone through all steps and Magic Link / OTP emails still won’t send, contact support, but send useful data so we don’t play email ping-pong.
1) Copy VentraConnect diagnostics
- Go to VentraConnect → Diagnostics & Tools.
- Scroll to Logs & export.
- Click Copy diagnostics.
- Paste this into your support email/ticket.
VentraConnect does not keep a log of individual Magic Link or OTP emails sent, so also include your SMTP plugin’s log entries for the failing send.
2) Include these details
Along with the diagnostics output, please include:
- A short description, for example “Magic Link emails not sending on WooCommerce checkout”
- The exact form you’re using: WordPress login; WooCommerce login / checkout / My Account; comment form; membership / LMS login page
- A screenshot of your Magic Link settings and your OTP (Email) settings (if relevant)
- Whether SMTP plugin test emails work
- Whether contact form plugin emails work
- Whether the VentraConnect Send test email arrives
Send this to support and we can see very quickly if it’s a configuration issue, a host-level email problem, or a genuine bug.