Table of Contents
Problem description #
The verification CTA (button or link) does not display in the received email or is stripped by the email client.
Symptoms:
- Email shows plain text or missing button.
- Clicking the provided link does nothing or shows invalid token.
Typical causes:
- Email client (e.g., some webmail/enterprise filters) strips HTML buttons.
- Plugin’s HTML template being modified by other plugins or by email service that converts/strips HTML.
- Minification or filter that alters the email output.
Solution (step-by-step)
- Ask user to view the raw message. In the email client open “View original” or “Show raw message” to see if the verification link is present in plain text. If present, they can use the raw link.
- Switch email template to include plain link fallback: If the plugin allows editing templates, add a fallback plain URL under the button (e.g., “If the button doesn’t work, paste this URL into your browser: [verification_link]”). If the plugin UI doesn’t allow it, request template update from support.
- Test with different email clients: Send to a Gmail and Outlook address to compare behavior.
- Disable any email HTML filters / plugins (that transform outgoing email) temporarily and test again.
- If using an SMTP provider, check if they rewrite or sanitize emails. Some providers remove buttons — try sending via a different provider for testing.
Prerequisites
- Access to modify plugin email template (if available) or to request plugin author to add plain link fallback.
Additional notes
- Always include a plain link fallback in transactional emails to maximize compatibility.
