Monitoring & Logs
Magic Link Health Check for WordPress Logins
Not sure whether Magic Link is set up correctly on your WordPress site? The free Health page runs a set of self-checks and rolls them up into a single status, so you can confirm sign-in emails will send and links will work before your users hit a problem. Open it under Magic Link → Health.
What is the Health page?
The Health page is a built-in diagnostics screen that verifies the parts Magic Link depends on: WordPress mail, the plugin's database tables, scanner protection, and your token settings. Each check reports OK, a warning, or a failure, and the page combines them into one overall status. It is included in the free version.
Open the Health page
- In the WordPress admin, go to Magic Link → Health.
- Review each check and its message.
- Read the overall rollup status at a glance (see below).
What the Health page checks
Email sending (wp_mail)
Confirms that WordPress can send mail through wp_mail. Magic Link is email-based, so if this check fails, users will not receive their sign-in links.
If it fails: install and configure an SMTP plugin, or fix your host's mail settings, then send a test email. See Troubleshooting.
Database table integrity
Confirms that the plugin's database tables exist and are intact. These tables store magic links and audit-log events.
If it fails: deactivate and reactivate the plugin so the tables are recreated. If the problem persists, see Troubleshooting.
Scanner-protection status
Confirms that Intent Confirmation (scanner protection) is active. This is the short "confirm it's you" page that stops email and link scanners — such as Outlook Safe Links, Mimecast, and Proofpoint — from silently consuming a one-time link before the user clicks it.
If it warns: scanner protection has been turned off, which can let single-use links be consumed early. Review your settings and any caching or security layer that might interfere with the confirmation page.
Token-lifespan sanity
Checks that your token lifespan is a sensible value — not zero or negative, and not so long that links stay valid for over a week and weaken security.
If it warns or fails: adjust Token Lifespan and Token Validity under Magic Link → Settings → General, or on the expiry settings page.
Reading the rollup status
The page combines all checks into one overall status. It reports fail if any single check fails, warn if any check warns but none fail, and OK only when every check passes. If the rollup is not OK, open the check that reported the problem and follow the guidance above.
Conclusion
The free Health page is the fastest way to confirm Magic Link can do its job — mail sends, tables are present, scanners are blocked, and tokens are sane — all from one status. If a check fails, follow its fix, then confirm real activity in the Audit Log and see Troubleshooting for deeper issues.
FAQs
Is the Magic Link Health page free?
Yes. The Health page is part of the free version of Magic Link. It runs four self-checks — mail sending, database tables, scanner protection, and token lifespan — and shows a single rollup status, with no PRO license required.
Why are my users not receiving magic link emails?
Start at Magic Link → Health and check the Email sending (wp_mail) result. If it fails, WordPress cannot send mail, so install and configure an SMTP plugin or fix your host's mail settings. You can also filter the Audit Log for Failed or Bounced events to confirm the delivery problem.
What does the scanner-protection check do?
It confirms Intent Confirmation is active — the "confirm it's you" step that stops email scanners like Outlook Safe Links, Mimecast, and Proofpoint from silently opening a one-time link and consuming it before the user clicks. If the check warns, protection is off and single-use links may be used up early.
The Health page says a database table is missing. How do I fix it?
Deactivate and reactivate the Magic Link plugin. The plugin recreates its required tables — the magic-links table and the audit-log table — on activation. Re-run the Health check afterward; if the table is still reported missing, see Troubleshooting.
What is a safe token lifespan?
Keep it above zero and no longer than about seven days. The Health page warns if the lifespan is set past a week, since long-lived links weaken security, and fails if it is zero or negative. Set Token Lifespan and Token Validity under Magic Link → Settings → General to a value that gives users time to click without staying valid too long.