> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instantcampaign.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add to calendar

> Buttons that save your event in the reader's calendar in one click.

The **Add to calendar** block puts a row of buttons in your email: Google, Outlook.com, Office 365, Yahoo and Apple / iCal. A click opens the reader's calendar with your event already filled in: title, time, location and description. The buttons are ordinary links, so they work in every mail app.

Use it for webinars, launches, sale start dates, store openings, appointments and anything else you want people to turn up to.

## Add the block

1. In the email builder, open the **Media** group and add **Add to calendar**. In Write mode, type `/` on an empty line and pick it from the list.
2. Write the event title.
3. Set the start and end, and pick the time zone you mean them in. Readers in other zones see the event at the right local time in their own calendar.
4. Tick **All-day event** for a date without a time, such as a sale day. The event then covers whole days in the time zone you picked.
5. Optionally add a location (an address or a meeting link) and a description.
6. Choose which calendars get a button. You need at least one. Each button's text can be changed; leave it empty to show the calendar's name.
7. Pick a look (**Solid**, **Outline** or **Link**), the button colour and the corner radius.

The preview tab opens the real Google, Outlook and Yahoo links, so you can check the event before you send.

## Which button does what

| Button | What happens |
| - | - |
| Google | Opens Google Calendar with the event ready to save. |
| Outlook.com | Opens Outlook on the web for personal Microsoft accounts. |
| Office 365 | Opens Outlook on the web for work and school accounts. |
| Yahoo | Opens Yahoo Calendar. |
| Apple / iCal | Downloads an `.ics` file. Apple Calendar, desktop Outlook and most other calendar apps open it and offer to add the event. |

The `.ics` file is served from your workspace's link domain (your custom endpoint, if you set one up).

## Give each contact their own time

In an automation email or a transactional email, the event can come from the data that started it. Under **Times from data**, enter a Liquid path such as `data.appointment.start`, and `data.appointment.end` for the end. Each contact then gets their own appointment in their calendar. Leave the end empty to make the event one hour long.

The title, location and description can hold Liquid tags too, for example `Your visit with {{ data.appointment.doctor }}`.

If a contact's data has no usable date, their buttons do nothing rather than adding a wrong event. Dates in ISO format, such as `2026-12-01T09:30:00Z`, work best.

## Tracking

Each button is a tracked link. Clicks show up in the campaign and automation link reports with one row per calendar, and you can build a segment of everyone who clicked one, such as people who saved the webinar.

A click means the reader opened their calendar with the event. InstantCampaign cannot see whether they then pressed save.

## Before you send

When you review a campaign, InstantCampaign warns you if the event starts before the email goes out (or before the scheduled send time), because readers would save an event that has already begun. Times taken from data are not checked. The warning does not stop the send.

## Related

* [Countdown timer](https://docs.instantcampaign.ai/guides/email-and-templates/countdown.md)
* [Blocks and layout](https://docs.instantcampaign.ai/guides/email-and-templates/blocks-and-layout.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.