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.

Generate email-safe 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:

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

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.

Create an email-safe button block