Why Anchor Links Stop Working in Mailchimp (And How to Fix Them Fast)
anchor links not working in mailchimp is one of the most frustrating email design problems you can run into. Here’s a quick summary of the most common causes and fixes:
- URL prefixing – Mailchimp’s import process prepends your source URL to anchor hrefs, breaking internal navigation
- Missing
tag fix – Importing custom HTML? Addto yourbefore importing - Wrong protocol – All links need
http://orhttps://to work correctly after click tracking is applied - Builder method matters – Anchors must be set using Mailchimp’s built-in link tool, not raw custom code
- Email client gaps – Anchor links simply don’t work in every email client; always test before sending
- Click tracking conflict – Mailchimp cannot track anchor links; they won’t appear in your click reports
These issues can silently break your email navigation, your table of contents, and even your social sharing buttons — without any obvious error message.
The good news? Most of these problems are fixable once you know what’s causing them.
I’m Ron Vernon, CEO of ELMNTL, a strategic marketing agency where I’ve helped brand owners and marketing teams build high-performing email campaigns — including diagnosing and resolving anchor links not working in mailchimp across both standard and custom-coded templates. Let’s walk through every fix so your jump links work exactly the way they should.
Why Are Your Anchor Links Not Working in Mailchimp?
When we talk about anchor links (also known as “jump links”), we’re referring to those handy shortcuts that let a reader skip from a Table of Contents directly to a specific section of your newsletter. In a perfect world, they make your content a breeze to navigate. In the real world, anchor links not working in mailchimp is a common headache that often stems from how the platform processes your code.
One of the primary culprits is a behavior called “URL prepending.” When you import content via a URL or use the API, Mailchimp’s system tries to be helpful by ensuring every link has a destination. However, it often mistakenly attaches the source URL of your newsletter to the beginning of your internal anchor tags. Instead of jumping to #section1 within the email, the link tries to go to https://yourwebsite.com/newsletter#section1. This usually results in the link opening a new browser window rather than scrolling down the page.
Furthermore, query strings used for Google Analytics and other tracking features can interfere. Mailchimp adds these parameters to your links to help you see who is clicking what, but because anchor links aren’t technically “destinations” on the web (they are locations within a document), the tracking code can break the jump functionality. Understanding is email marketing effective often comes down to these technical details; if your navigation is broken, your engagement metrics will suffer.
The Impact of Automatic URL Prefixing
As we’ve seen in technical forums and support logs, this “URL prefixing” doesn’t just break your Table of Contents. It can have a domino effect on your entire campaign. When Mailchimp modifies the source URL, it can disrupt Troubleshoot Broken Links efforts by making it appear as though the link is formatted correctly in the editor, while it fails in the actual inbox.
This processing can even break social sharing buttons. If your Twitter or Facebook buttons are pulled in via an API import, the same prefixing logic might apply, causing the buttons to fail to render or redirecting users to the wrong place. This is particularly common when using the “URL Import” feature, where Mailchimp fetches a page and tries to “fix” the links for email compatibility.
Email Client Compatibility and Gmail Clipping
Even if your code is perfect, the “inbox environment” is a wild place. Not every email client supports anchor links. While most modern browsers and apps like Gmail (desktop) handle them well, some mobile versions or older Outlook clients might ignore the “jump” command entirely.
Another invisible enemy is the 102KB limit. Gmail is famous for “clipping” emails that exceed this file size. When an email is truncated, the bottom half of your content—and the anchors you’re trying to jump to—might not even be loaded yet. This makes the ultimate guide to crafting an intuitive and engaging website user experience just as relevant for email; if the user can’t reach the content, the experience is broken. Using “Read More” links with anchors is a common strategy to combat clipping, but it requires precise implementation to work.
Troubleshooting Common Causes of Broken Jump Links
Before we dive into the code, it’s important to recognize that Mailchimp offers two different editing experiences: the New Builder and the Legacy Builder. The way you handle anchors differs between them.
One common mistake is using the wrong protocol. Mailchimp officially supports mailto:, HTTP, and HTTPS. However, File Transfer Protocol (FTP) links and mobile deep links are not supported. If you try to use these for your anchors, the links will likely be stripped or broken. For those focused on tips for optimizing your website for conversions, a broken link in an email is a lost conversion opportunity.
Fixing the Tag Issue for Anchor Links Not Working in Mailchimp
If you are a power user importing custom HTML templates, you might notice your anchors work in your code editor but fail the moment they hit Mailchimp. This is often due to the tag. When Mailchimp imports HTML, it sometimes inserts its own tag in the section to resolve relative image paths. Unfortunately, this tag tells the browser that all links—including your #anchor links—should be relative to a specific URL, which breaks the “internal” nature of the jump.
The fix? Before you import your code, manually add a blank base tag to your HTML:
This prevents Mailchimp from adding its own version and preserves the functionality of your internal links. This is a critical step often found in the ultimate seo website redesign checklist for those migrating content between platforms.
Resolving Click Tracking Conflicts with Anchor Links Not Working in Mailchimp
Click tracking is the lifeblood of email Reports, but it is the natural enemy of the anchor link. Mailchimp tracks clicks by wrapping your URLs in a redirect. Since an anchor link like #top isn’t a real page, the redirect doesn’t know where to go, often leading to a 404 or simply reloading the page in a new window.
To avoid this, you must accept a trade-off: you cannot track clicks on anchor links. If you see your links redirecting to a Mailchimp “mcsv-static” page, it’s a sign that click tracking or a spam filter has mangled the link. Use the Mailchimp link checker tool to verify that your anchors are excluded from tracking. For more on managing your campaigns, check our tag/email-marketing resources.
Step-by-Step: How to Create Working Anchor Links
Let’s get practical. Whether you’re building a restaurant email marketing campaign with a long menu or a monthly newsletter, here is how to set up anchors correctly.
Using the Table of Contents Merge Tag
The easiest way to avoid anchor links not working in mailchimp is to use the built-in Table of Contents merge tag: *|MC:TOC|*.
- Format your headings: In your email, highlight the text you want to appear in the TOC and set it as “Heading 1” or “Heading 2” in the styles menu.
- Add the tag: Place the
*|MC:TOC|*merge tag where you want the list to appear. - Customize with CSS: In the New Builder, you can add the class
mc-toc-titleto your headings in the HTML view to ensure they are picked up.
This method is highly recommended because Mailchimp handles the anchor generation for you, reducing the chance of manual coding errors. As noted in How to Use Jump Links to Enhance User Experience | Mailchimp, a well-structured TOC is one of the 4 qualities of a great website and email alike.
Manual Anchor Implementation in the New Builder
If you want more control than the merge tag offers, follow these steps in the New Builder:
- Set the Target: Click on the Heading or Paragraph block you want to jump to. In the settings panel on the side, look for the “Anchor” or “ID” field. Enter a unique name (e.g.,
special-offer). Crucial: Use no spaces and no special characters. - Create the Link: Highlight the text you want to use as the trigger (e.g., “Jump to Special Offer”). Click the Link icon.
- Link to Anchor: In the link dropdown, change the link type to “Anchor.” Select the name you just created from the list.
By using the built-in tool rather than typing manually, you ensure that Mailchimp’s internal logic recognizes the link as an internal jump and doesn’t try to “fix” it with a URL prefix.
Frequently Asked Questions about Mailchimp Anchor Links
Why does my anchor link open in a new window?
This is almost always caused by Mailchimp (or your browser) treating the anchor as an absolute URL. If the link looks like https://us1.campaign-archive.com/.../#target, the browser thinks it’s a new page. This often happens in “Preview Mode” or when viewing the “Archive” version of an email. To fix it, ensure you are using the “Anchor” link type in the Mailchimp editor rather than a “Web Address” link type. Check the Troubleshoot Broken Links | Mailchimp guide for more details on link targets.
How do I fix anchor links not working in Mailchimp after an API import?
This is a known issue documented in Anchor Link Troubles – Google Groups. When the API pulls content, it often prepends the source URL.
- The Workaround: Use relative paths in your source code (e.g.,
href="#section") and ensure you have the blanktag in your header. - Support Escalation: If the issue persists, contact Mailchimp support and specifically mention that your anchors are being prefixed during the URL import process. This is often a system-level behavior that requires their technical team to adjust.
Can I track clicks on internal jump links?
The short answer is no. Mailchimp’s click tracking relies on redirecting the user to a new URL, which breaks the “jump” behavior of an anchor. If you must track these, you would need to link to an external web page instead of an internal anchor. Most marketers accept the lack of tracking for anchors in exchange for the vastly improved user experience of a navigable email.
Conclusion
At ELMNTL, we believe that every detail of your integrated marketing strategy matters—down to the last jump link. While anchor links not working in mailchimp can be a technical hurdle, following the protocols of using built-in tools, managing your tags, and testing across multiple email clients will ensure your audience stays engaged.
Always use “Preview Mode” and send live tests to a variety of devices before hitting “Send.” If you’re looking for a partner to help streamline your digital presence and solve these pesky technical challenges, we’re here to help.