Most issues fall into one of three categories: email delivery, state
page setup, or form behavior. Work through the relevant section below.
If the issue persists,
open a support ticket with the specific error
text and your WordPress and PHP versions.
Lead emails not arriving
-
Go to Medigap Pro → Settings and confirm the
Notification Email field is set and correct.
-
Click Send Test Email from the Settings page. If
the test fails, the issue is with your outbound mail configuration,
not the plugin.
-
If using SMTP: double-check host, port (587 for TLS, 465 for SSL),
username, and password. Test credentials directly with your SMTP
provider’s dashboard.
-
If using
wp_mail(): your hosting provider may block
outbound port 25/587. Install a dedicated SMTP plugin (WP Mail SMTP,
Post SMTP) or configure Medigap Pro’s built-in SMTP panel.
-
Check your spam folder — the notification email may be delivered but
filtered.
-
Confirm your “From” address matches your SMTP sending domain (many
providers reject address mismatches).
State pages returning 404
-
Go to Medigap Pro → Site Setup and click
Rebuild State Pages. This regenerates all 50 state
landing pages.
-
Confirm your state page URL pattern under
Settings → Landing Pages matches your actual
permalink structure. The pattern must use the
{state} placeholder.
-
Flush WordPress rewrite rules: go to
Settings → Permalinks and click
Save Changes (no changes needed — just saving
flushes the rules).
-
If using a caching plugin, clear the full site cache after
rebuilding pages.
Lead form not submitting
-
Honeypot triggered: if the form was submitted too
quickly (common with bots or browser autofill), the submission is
silently discarded. Reload and resubmit manually.
-
Open your browser’s Developer Tools console (F12) and check for
JavaScript errors that may be preventing form advancement.
-
If the page is cached, flush the cache after placing the shortcode.
A cached version of the page may have a stale nonce that causes
submission failures.
-
Confirm the shortcode page is Published, not Draft
or Private.
Plan comparison grid email gate not triggering
-
Confirm
[medigap_benefits_grid] is on a published page
with no page-builder wrapper that might strip shortcode output.
-
Check that the notification email is set under Settings — the
softgate requires a valid destination to capture the email lead.
-
If the grid appears but no gate shows, check for a JavaScript
conflict with your theme or other plugins using browser console
errors (F12 → Console).
CSV export is empty
-
Go to Medigap Pro → Leads and confirm leads are
listed in the table. If no leads appear, no submissions have been
stored yet.
-
CSV export requires the Administrator role (
manage_options
capability). Editor and lower roles cannot export.
-
The leads table shows the last 200 records. The CSV export includes
all stored leads.
Setup wizard not appearing after activation
Navigate directly to Medigap Pro → Restart Wizard in
the WordPress sidebar. The auto-launch on activation runs only once;
re-running it from the menu is always available.
