Guides
Add-to-calendar buttons that work in email
If you paste a JavaScript “Add to Calendar” widget into Mailchimp, Substack, or Beehiiv, it will look like a blank hole — or worse, get stripped. Email is not a browser.
Copy a ready-made HTML block. AddToIcs gives you table-based buttons with inline styles, plus a plain-link version for newsletters that strip HTML.
Why widgets fail in the inbox
Gmail, Outlook on Windows, Apple Mail, and almost every webmail client do not run JavaScript in message bodies. Many also strip <style> blocks, flexbox, and forms. A beautiful web component that works on your website has nothing to execute once it is mailed.
The reliable pattern is old-fashioned on purpose:
- A
<table role="presentation">for layout - Inline
style=""on every cell and link - System fonts (Arial, Helvetica)
- Each calendar as its own
<a href="…"> - No scripts, no web fonts, no dependent CSS files
One button, or one button per calendar?
A single “Add to Calendar” image that points at an event landing page is clean, and it survives when the recipient has images turned off if you include alt text and a line of plain links underneath. The landing page then offers Google, Outlook, Office 365, Apple, and Yahoo.
A row of labeled buttons (Google, Outlook, Apple…) removes a click and often converts better in newsletters, at the cost of a busier footer. AddToIcs can generate both: colored table buttons, or an image button plus the same links.
The Apple / .ics problem
Google, Outlook.com, Office 365, and Yahoo can be linked directly — the URL opens a pre-filled event. Apple Calendar and most desktop clients want a real .ics file served with a calendar content type. You cannot attach that file “from” a generator inside the email, and the message cannot build it with JavaScript.
The workable static approach is to link Apple users to a small page on your site that already knows the event (in AddToIcs, /e.html?… with the details in the query string). That page offers an .ics download. A later hosted plan can serve the file with the proper text/calendar header and a short URL you can edit after send.
Mailchimp, Substack, and Beehiiv
- Mailchimp — use a code block, or an HTML content block, and paste the table. Test in their preview, then send a real test to Gmail and Outlook.
- Beehiiv — paste into an HTML / custom module. Watch the width; keep the button table left-aligned and compact.
- Substack — the composer is stricter. A single event-page link, or the plain-text list of calendar URLs, is the most dependable option. If you have access to an HTML block, the same table works.
Always send yourself a test. Outlook on Windows is the usual holdout: rounded corners and padding may flatten, which is why the generator sticks to solid-color table buttons rather than fancy CSS.
Images are optional, alt text is not
Many clients block images until the reader allows them. If you use a picture of a button, give it a clear alt="Add to Calendar" and put text links immediately under it. Never rely on the image alone.