Customize Embeddable Calendars

An embeddable calendar is a powerful tool that allows you to both have a presentation of the calendar with your events and give your attendees the ability to add to the events they are interested in - or subscribe to the whole calendar. In this article, we will review the process of embedding your calendar into a web page.

Navigating to the embeddable calendar

  1. Please open the Calendar page of the calendar you want to embed. Scroll down to the Embeddable calendar section.

There are two options here for customizing the way your embedded calendar looks:

  • Quick Customize - Clicking this button will open a quick editor that allows you to select the default variant of the overall layout, as well as some other optional elements, such as a month/week switcher, timezone selector, or subscribe button.
  • Custom templates - This section allows you to create and customize a template for your embeddable calendar using HTML markup. This tool requires some understanding of HTML/CSS, but in turn, it provides more options for how you want the calendar to look, such as inserting header images, changing button text, and changing fonts or colors.

Let's review each option in more detail.

Quick customize

Clicking this button will open a window with the preview of the embedded calendar in the middle and the options for customization on the left.

  1. You can select which elements you want to be displayed here, the default time format, the first day of the week, and the calendar that you want to be displayed in this format.

  2. Once you've selected all the needed parameters, please click Copy Code to obtain the HTML code of the calendar view you've constructed. Once you've obtained the code of the calendar, you can embed it into the Web page by inserting the code in the appropriate location of the page.

Also, there is an alternative method of integrating the page by using an iFrame.

iFrame method

  1. Please set all the needed customization options for the calendar, then right-click on the calendar and click Inspect(the exact name or location of the option may differ depending on your browser).

  2. In the developer tools, please look for the line that looks like this:

  3. Here, you can see the iframe URL after src= parameter. Please copy this URL and insert it instead of YOUR_CALENDAR_URL in the following snippet:

    <iframe src="YOUR_CALENDAR_URL" style="width:100%;height:100%;display:block;border:0;"></iframe>
    
  4. As a result, your snippet should look similar to this:

Now, you can insert this iframe into the landing page you need.

Custom Templates

This option allows more robust editing of your embedded calendar.

  1. Please click Custom Templates in the Calendar landing page section to access the template editor:

  2. Here, please click + New Template:

  3. You will be directed to the Custom Template editor page:

This page consists of three sections:

  • Template details
  • Template code
  • Data tags and attributes

In the context of this tutorial, we are interested in the first two.

Template details

The first section contains the fields describing the template: Name, language, and Template ID.

In the first field, you can specify any template name you need. The second field allows you to select the language/locale that will be used for date formatting and some hardcoded elements, such as ToS consent. The third field contains the unique Template ID (the third field will appear once the template is saved).

Template code

The second section contains the code of the template.

  1. Here you can make the changes you need. Please check this section of our documentation for examples of what you can do with your template.

  2. Once you've made all the needed changes in the code section, please specify the name of the template and click Save:

Applying the template and embedding the calendar

Once the template is saved, you can apply it to all the calendars you want to be using this template. This can be done on the calendar page.

  1. Please navigate to the Embeddable Calendar section of the Calendar page:

  2. Please select the needed template from the dropdown and click Set.

  3. Now, you can copy the code for embedding your calendar by clicking Copy Code at the Embed code box:

  4. Just like with the Quick Customize method, you can now insert the code in the needed place of the Web page to embed the calendar. Please keep in mind that there is no iframe option available for the Custom Template.