Embed options overview

Using the developer embed code

By making a JavaScript API call, you can create an inline embed on demand. This will allow you to delay the appearance of the embed until specific actions are completed, or until information is collected to be used for pre-filling the booking form.

Create a div on your site with a specific ID. Include the Calendly Javascript file somewhere on your site as well:

<script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js"></script>

Then use this API call, making sure to replace the sample text with your div ID:

Calendly.initInlineWidget({
 url: 'https://calendly.com/YOURLINK',
 parentElement: document.getElementById('SAMPLEdivID'),
 prefill: {},
 utm: {}
});

Load the inline embed automatically while still pre-filling questions, or while setting UTM parameters, use the following code:

<!-- Calendly inline widget begin -->

<div id="calendly-embed" style="min-width:320px;height:700px;"></div>

<script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js"></script>

<script>
Calendly.initInlineWidget({
url: 'https://calendly.com/YOURLINK',
parentElement: document.getElementById('calendly-embed')
});
</script>

<!-- Calendly inline widget end -->

Make sure to include the parentElement, otherwise the embed will always load at the bottom of your web page.

Hiding event details

Remove any information that is duplicated by the content of your web page by hiding the event details, such as your Calendly account picture, name, or event location. Add one of the following URL parameters to the code, depending on the type of scheduling link you are embedding:

A profile page or team page link:

An event type-specific link:

Hiding the cookie banner in the embed

A cookie banner will show by default within the frame of the page that Calendly loads. Without making any changes to your website, the banner keeps you compliant with privacy regulations worldwide (GDPR, CCPA, etc.) when users visit your page and interact with the Calendly widget. Calendly does provide the option for you to hide the cookie banner as a configurable property when embedding your Calendly booking page.

However, by hiding the banner, your site takes responsibility in managing customer preferences to remain compliant with global privacy regulations. When Calendly is embedded, and the banner is hidden, Calendly will still use cookies. Therefore, our recommendation is to prevent Calendly from loading unless users have opted into performance cookies.

How to hide the cookie banner on your existing embed code:

1. If you've already embedded Calendly on your website, access your Calendly embed code from the HTML editor on your site.
2. In your embed code, add the following parameter to your Calendly link: hide_gdpr_banner=1

The final code will look something like this:

<div class="calendly-inline-widget" data-url="https://calendly.com/YOUR_EVENT?hide_gdpr_banner=1" style="min-width:320px;height:630px;"></div><script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js"></script>

How to hide the cookie banner when creating new embed code for your site:

Follow the steps in Embedding Calendly on your site. Make sure to select Hide Cookie Banner before copying the code:

Notifying the parent window

The embedded scheduling page notifies the parent window of important events during the booking flow. As a developer, you can subscribe to these notifications to fire analytics events or change the state of your app.

We use window.postMessage() to post events to the parent window. The event payload is a JavaScript object of the following format where XXX is the name of the booking flow event:

{ event: 'calendly.XXX' }

Here are the events Calendly fires when an invitee follows the booking flow:

This example code listens to these events and logs them to the console:

function isCalendlyEvent(e) {
  return e.origin === "https://calendly.com" && e.data.event && e.data.event.indexOf("calendly.") === 0;
};
 
window.addEventListener("message", function(e) {
  if(isCalendlyEvent(e)) {
    /* Example to get the name of the event */
    console.log("Event name:", e.data.event);
    
    /* Example to get the payload of the event */
    console.log("Event details:", e.data.payload);
  }
});

Pre-Fill questions 

If you've already gathered information from visitors to your webpage, you can have it pre-populated in the booking form by modifying Javascript calls in the embed code. Prefill parameters are set in the following structure:

prefill: {
    name:
    email:
    customAnswers:
}

If your event type takes separate first name and last name fields you can use firstName and lastName instead of name.

You can also set custom answers to invitee questions you've added to your event type. Each custom answer will be numbered in order as a1, a2, a3, and up to a10.

prefill: {
    customAnswers: {
        a1:
        a2:
        a3:
    }  
}

<script>
    Calendly.initInlineWidget({
        url: 'https://calendly.com/YOUR_LINK/30min',
        prefill: {
            name: "John Doe",
            email: "john@doe2.com",
            customAnswers: {
                a1: "Yes",
                a2: "At the Starbucks on 3rd and 16th"
            }
        }         
   });
</script>