Guides · Updated 2026-10-26

How do I add an add-to-calendar link to an email?

Can you put an add-to-calendar button in an email?

Yes, but only as links. A “button” in an email is an HTML link styled to look like one. Website add-to-calendar widgets rely on JavaScript to open a menu and build files on the fly, and email clients do not run scripts, so those widgets fail in Gmail, Outlook and Apple Mail.

The working pattern is a row of links, one for each calendar your audience uses:

None of these URL formats is officially documented by Google, Microsoft or Yahoo. The parameters come from community testing, collected in the add-event-to-calendar-docs repository (last checked 2026-08-19). Apple has no web “add event” URL, so Apple users need the .ics file.

How do I build the links by hand?

Fill in each calendar’s URL template with your event’s title, start and end time, location and description, then URL-encode the values. For example, a Google Calendar link uses dates=20261114T090000Z/20261114T100000Z, where the trailing Z means UTC and both halves need it. For an all-day event, use dates only, with the end date set to the following day: dates=20261114/20261115.

Convert times to UTC before you build the links. That avoids most “the event shows at the wrong hour” reports, because each calendar then converts to the recipient’s own time zone. See hand-built links for the full parameter list, costs and limits.

Then paste each URL into your email:

• Gmail: insert a link (Ctrl/Cmd+K) on text such as “Add to Google Calendar”.
• Outlook: insert a hyperlink the same way; Outlook keeps standard https links.
• Mailchimp and other email platforms: add a button or text block and set its link to each URL.

Keep each URL well under a few thousand characters. The community docs measured about 31,000 characters as a best case for Outlook.com’s server, but browsers, link trackers and email clients set lower limits, so long descriptions are the usual cause of broken links.

Should I use a link to an .ics file or an .ics attachment?

Use a link to a hosted .ics file for marketing and newsletter emails. An .ics file is a plain-text calendar event defined by RFC 5545; see .ics files explained for what goes in one.

An attachment makes more sense for one-to-one emails, such as a booking confirmation. If you want the recipient to get accept and decline buttons and later updates, send a calendar invitation from your calendar or booking system instead; that uses the scheduling rules in RFC 5546 rather than a static file.

Why don’t add-to-calendar buttons work in some email clients?

Most failures come from one of four causes:

1. JavaScript. Script-based buttons never render in email.
2. Link rewriting. Email platforms wrap links for click tracking. That is usually fine, but a very long calendar URL can be cut off or break after redirection.
3. Wrong Microsoft host. An outlook.live.com link opens a personal Outlook.com account and an outlook.office.com link opens a work or school account. Offer both. Outlook has its own quirks, covered in why add-to-calendar breaks in Outlook.
4. Time zones. A time without Z or a time zone is read in the viewer’s own time zone, so the event shifts for anyone elsewhere.

Should I use a hosted service or make links myself?

It depends on whether you need updates and data after you hit send.

Hand-made links suit a one-off event and a small list. A hosted service suits recurring campaigns, many events, or teams that need analytics. Compare plans, add caps and test results on the comparison table, the pricing page and best free options.

Questions