Troubleshooting
WordPress Email Link Not Working: Causes and How to Fix It

Short answer
A WordPress email link usually stops working because the link lacks the mailto prefix, the address has a typo, or the visitor's device has no default email app. Email obfuscation scripts, caching and badly encoded subject lines can also break the link.
Key takeaways
- Email links must start with mailto: followed by the address.
- Many failed clicks come from visitors with no default mail app.
- Encode spaces and symbols in subject and body parameters.
- Cloudflare obfuscation or anti-spam scripts can break links when blocked.
- Show the address as text or add a contact form as a backup.
Why is your WordPress email link not working?
A WordPress email link usually fails because the link is missing the mailto: prefix, the visitor's device has no default email app set, or an email protection feature, cache or script has broken the link.
An email link is a normal link that starts with mailto: instead of https://. When someone clicks it, their device opens its default email program with your address filled in.
That means there are two places a problem can come from. Either the link itself is wrong, or the visitor's computer does not know which app should handle it.
This guide covers both. If your real problem is that your site does not send emails, such as form notifications, see our guide on fixing WordPress not sending emails instead.
Is the link missing the mailto: prefix?
The most common cause is a link that points to https://[email protected] or just [email protected] instead of mailto:[email protected], which makes the browser treat it as a web address.
The correct format is:
<a href="mailto:[email protected]">[email protected]</a>
To check your link:
- Edit the page in WordPress.
- Click the email link and open its link settings.
- Look at the full URL. It must start with mailto:.
- If it starts with http:// or https://, replace it with mailto: followed by the address.
- Update the page.
The block editor usually recognises an email address typed into the link box and adds mailto: for you. Page builders, button widgets and older themes do not always do this, so check button links carefully.
MDN's reference for the anchor element lists mailto: among the supported link types.
Is there a typo or extra space in the address?
Yes, a stray space, a missing letter or a copied invisible character inside the link will break it or send email to the wrong place, so retype the address by hand.
Look out for:
- A space after mailto: or at the end of the address.
- Smart quotes or invisible characters copied from a word processor.
- A wrong domain, such as .con instead of .com.
- Two addresses joined without a comma.
Switch the block to HTML view with Edit as HTML and check the href value. Everything inside the quotes should be one unbroken line.
Does the visitor's device have a default email app?
Often the link is fine but nothing happens because the visitor's computer has no default mail app, or it opens a desktop app they never use, which is common for people who only use webmail.
This is the cause behind many it does nothing when I click reports. You can confirm it by testing the link on a phone, where a mail app is usually set up.
Visitors can fix it on their side:
- Windows: set a default app for MAILTO in the default apps settings.
- macOS: choose a default email reader in the Mail app settings.
- Chrome and other browsers: Gmail and some webmail services can register as the handler for email links, if the user allows it.
You cannot change visitors' settings, so give them another option. Show the address as plain text next to the link, add a copy button, or offer a contact form.
Are the subject and body parameters formatted correctly?
If you add a subject or message to the link, spaces and special characters must be encoded, and the first extra parameter must start with ? while the rest use &, or the link may break.
A correct example:
<a href="mailto:[email protected]?subject=Website%20enquiry&body=Hi%20there">Email us</a>
Rules to follow:
- Use ? before the first parameter and & between the rest.
- Replace spaces with %20.
- Encode line breaks in the body as %0D%0A.
- Avoid unencoded characters such as #, & or ? inside the subject text.
The rules come from the mailto standard, RFC 6068. If in doubt, remove the subject and body and test the plain link first.
Is email obfuscation breaking the link?
Yes, tools that hide your address from spam bots, such as Cloudflare's email obfuscation or anti-spam plugins, rewrite the link and rely on JavaScript to restore it, so the link breaks if that script is blocked or altered.
Signs of this problem:
- The link points to /cdn-cgi/l/email-protection in the page source.
- The address shows as [email protected] on the page.
- The link works when you are logged in but not for visitors, or the reverse.
Cloudflare documents the feature in its guide to email address obfuscation. It can be turned off in the Scrape Shield settings, or skipped for specific content.
Problems often start when an optimisation plugin delays, combines or defers the decoding script. Exclude that script from JavaScript optimisation, or turn off one of the two features.
WordPress also has a built-in antispambot() function that encodes addresses in HTML without JavaScript. Developers can use it in templates as a lighter alternative.
Could a plugin, cache or security setting be the cause?
Yes, caching can serve an old broken version of the link, minify and defer settings can break link scripts, and strict security rules can block unusual link types, so clear caches and test with optimisation off.
Steps to narrow it down:
- Clear your caching plugin, server cache and CDN. Our guide on how to clear cache in WordPress covers each layer.
- Test in a private browser window.
- Turn off JavaScript minify, combine and delay options, then test again.
- Deactivate plugins one at a time on a staging site. Our guide on finding a plugin conflict explains the process.
A content security policy normally does not block mailto links. But if you have set one with unusual rules, review it with our guide on adding a content security policy.
Is the link set to open in a new tab?
Setting an email link to open in a new tab can leave visitors with an empty blank tab while the mail app opens, which looks broken, so turn off Open in new tab for mailto links.
In the block editor, click the link and switch off Open in new tab. In page builders, look for a target or new window option on the button.
Some browsers handle this fine. Others open a blank page that stays open. It is simplest to leave email links in the same tab.
Which cause matches what you see?
Use the symptom table to find the most likely cause quickly.
| What happens | Likely cause | Fix |
|---|---|---|
| Opens a 404 or web page | Missing mailto: prefix | Add mailto: to the link |
| Nothing happens on click | No default mail app | Show address as text, add a form |
| Wrong address appears | Typo or old cached page | Retype, clear cache |
| Shows [email protected] | Obfuscation script blocked | Exclude script or turn off feature |
| Subject is cut off | Unencoded characters | Encode spaces and symbols |
| Blank tab opens | Open in new tab enabled | Turn it off |
What is a better alternative to email links?
A contact form is often more reliable than an email link because it works on every device without a mail app, though you should still show your address as plain text for people who prefer it.
Many sites use both. The form handles most enquiries, and the visible address lets people copy it into their own webmail.
If you add a form, make sure your site can actually send email. Our guide on setting up email with your hosting is a good place to start.
If form messages never arrive, our guide to fixing contact form emails covers SMTP and delivery fixes.
Whatever you choose, test the link or form on a phone and a desktop after every theme or plugin change.
Frequently asked questions
How do I make an email link in WordPress?
Select the text in the block editor, click the link button and type mailto: followed by the email address. The block editor often adds mailto: automatically when you type an address. Check button and page builder links by hand.
Why does nothing happen when I click my email link?
Usually the visitor's computer has no default email app set, so the browser has nothing to open. The link itself may be fine. Test it on a phone, and offer the address as plain text or a contact form for webmail users.
Why does my email address show as email protected?
That text comes from email obfuscation, often Cloudflare's feature, which hides the address from bots and restores it with JavaScript. If that script is blocked or deferred by an optimisation plugin, the address and link stay hidden.
Can I add a subject line to a mailto link?
Yes. Add a question mark after the address, then subject= and your text, with spaces written as %20. Add more fields, like body, with an ampersand. Unencoded symbols can break the link, so keep it simple.
Should I use an email link or a contact form?
A contact form is more reliable because it works without a mail app on the visitor's device. Many sites use a form and also show the address as plain text, so people can choose whichever suits them.
Sources
- The Anchor element MDN Web Docs
- RFC 6068: The mailto URI Scheme RFC Editor
- Email Address Obfuscation Cloudflare Docs
- antispambot() function reference WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


