Magic Link Health Check

Quick Answer

The free Health page runs a set of self-checks and shows a single rollup status so you can confirm Magic Link is set up correctly. Open it under Magic Link > Health.

What It 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 links and audit 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 from silently consuming one-time links.

If it fails: review your settings and any caching or security layers that might interfere with the confirmation page. See Troubleshooting.

Token-Lifespan Sanity

Checks that the token lifespan and validity settings are within sensible ranges — not so short that links expire before users can click them, and not so long that they weaken security.

If it fails: adjust Token Lifespan and Token Validity under Magic Link > Settings > General.

Reading the Rollup Status

The page combines all checks into one overall status. A green, healthy status means everything passed. If any check reports a warning or error, open that check to see the detail and follow the guidance above.

For a full history of link events, see the Audit Log. For common problems and fixes, see Troubleshooting.