Add-to-calendar guide

Make it easy for subscribers to show up for your brand’s most momentous events with the Add-to-calendar capability in Litmus Personalize. With just a few clicks, you can create custom add-to-calendar links that let subscribers take action directly from your email.

Add-to-calendar supports Apple, Outlook, Google, and Yahoo calendars, as well as any calendar that accepts .ics files.

Create the Add-to-calendar button

Start in your Personalized content tab and select Add-to-calendar from the left menu options or the Add-to-calendar image option button.

litmus personalized content main page

Your Add-to-calendar widget's default name is the template name but you can edit it to whatever you prefer by selecting the name on the top left.

litmus personalize add to calendar design window with title edit indicated

Configure options

Set up your button with details about your event. Required items are:

  • Event title
  • Start date and time
  • End date and time (unless All-day event selected)

Optional items include:

  • Event description
  • Location

NOTE: Please verify your event Timezone to ensure your recipients' calendar event adjusts properly for their location.

Button styling

Adjust the width, height, background color, font face, text color, and button border color. You can include calendar links for all the major providers or toggle off that option.

animation showing configure menu options and button styling options

Add a custom TTF font

If you would like to use a custom font, you can upload a font file (TTF font files are supported). In the Button styling section, select the Upload font link above the font selection dropdown.

NOTE: Your custom font name will appear in the list with the same file name you upload.

Once your font has been uploaded, you can select it from the Font dropdown. Your uploaded font will be available in the Custom fonts section of the list and will be available to use in any other widget that has custom font capability.

Preview and finish

Once your button is set up, select the Copy HTML button to use the code right away in your email or Done to finish. The button code will be available in your Add-to-calendar library where you can copy the HTML or edit your add-to-calendar title.

add-to-calendar library with title edit and copy html indicated

Append customization parameters

Add-to-calendar widgets can be appended with code formats to customize the information they display. Use any of the following options with your finished add-to-calendar widget. You can combine the options for the perfect calendar event!

URL parameter

Calendar event detail

Example URL

tl

Title of the event (event summary, subject)
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?tl=New Event Title

st

Starting date & time
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?st=2025-07-01T08%3A00-05%3A00

et

Ending date & time
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?et=2025-08-01

des

Description of the event (event body)
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?des=Different description of the event

loc

Location of the event (e.g. address or link)
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?loc=Updated%20address

ad

Whether the event is an "all day" event or not
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?ad=true|false

Combine multiple parameters

Multiple parameters can be combined to update multiple event details, e.g. setting both the title tl and the all-day ad parameters. Add an ampersand & between parameters.

http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj28ip3/ics?tl=All-day%20Event&ad=true

All event details can be recreated by including a value for each of the available parameters.

Custom date format

You can append your completed calendar button code to different date formats. This requires manually editing the code to include a date/time parameter. Delete code after your designated times and append with a formatted time parameter.

https://image.ltms.app/ce/uy8898e3dz5m86jr8zpouzzx6.png?tl=Bring%20your%20pet%20to%20work%20day&st=2024-06-14T10%3A00%3A00.0000000-02%3A30&et=2024-06-15T18%3A00%3A00.0000000-02%3A30&ad=False&loc=http%3A%2F%2Flitmus.com

Calendar option examples

Event details are supported for the following calendar types.

URL path

Calendar type and action

Example URL

ics

ICS file download
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/ics?tl=New Event Title

google

Google Calendar generated URL
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/google?tl=New Event Title

outlook

Outlook Calendar generated URL
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/outlook?tl=New Event Title

yahoo

Yahoo Calendar generated URL
http://click.ltms.app/ce/3wnde97y22fd0y5ubfzj
28ip3/yahoo?tl=New Event Title

Impression usage

Add-to-calendar is a single image so any time one is loaded, it will count as one impression.

NOTE: Impressions usage limits vary based on your subscription. Learn more about usage limits and how impressions are counted to make sure you understand how your tag will impact your

Top

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us