> ## Documentation Index > Fetch the complete documentation index at: https://cal.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Embed Events > [!NOTE] > > For comprehensive documentation on embed events including usage examples and all available events, please refer to the [Cal.com Help Center - Embed Events](https://cal.com/help/embedding/embed-events). ## Internal Events These events are used internally by the embed system for communication between the iframe and parent window. They are prefixed with `__` and are not intended for external use. | Action | Description | Properties | | - | - | - | | \_\_iframeReady | Fired when the embedded iframe is ready to communicate with parent snippet. | `isPrerendering: boolean` // Whether the iframe is in prerender mode | | \_\_windowLoadComplete | Tells that window load for iframe is complete. | None | | \_\_dimensionChanged | Tells that dimensions of the content inside the iframe changed. | `iframeWidth: number` `iframeHeight: number` `isFirstTime: boolean` // Whether this is the first dimension change | | \_\_routeChanged | Fired when the route changes within the iframe. | None | | \_\_closeIframe | Fired when the iframe should be closed. | None | | \_\_connectInitiated | Fired when connection to a prerendered iframe is initiated. | None | | \_\_connectCompleted | Fired when connection to a prerendered iframe is completed. | None | | \_\_scrollByDistance | Instructs the parent to scroll by a specific distance. | `distance: number` // Distance in pixels to scroll by | > [!NOTE] > > Events that start with `__` are internal and should not be relied upon for external integrations as they may change without notice. To get more details on how Embed actually works, you can refer to this [Embed Flowchart](https://www.figma.com/file/zZ5oaUpg12Fuu5mGZrPlP5/Embed-Flowchart). ## Copy Prompt embed The Copy Prompt embed adds a button to your website that helps visitors book the event type through an AI assistant. Depending on the mode you pick, the button either copies booking instructions for the visitor to paste into their assistant, or opens one assistant with the instructions already typed. The assistant connects to the Cal.com MCP server and books the event type. To create one, open an event type's options menu, select **Embed**, and click the **Copy Prompt** button below the embed type cards. ![Embed dialog showing the four embed type cards with a Copy Prompt button and an AI assistant logo below them](https://mintcdn.com/calcom/k0Zn8ONd817nWESC/images/embed-events/copy-prompt-embed-type-chooser.png?fit=max\&auto=format\&n=k0Zn8ONd817nWESC\&q=85\&s=449d9ad954bce248a5a870d5e1da6d2c) The editor has these options: | Option | Description | | - | - | | Embed theme | `Auto`, `Dark theme` or `Light theme`. `Auto` follows the visitor's light or dark system setting; the other two always use the same colors. Black logos, such as ChatGPT's, turn white on a dark background. | | Assistant mode | **Multiple assistants** rotates through the selected assistants and copies the prompt on click. **Specific assistant** opens one assistant in a new tab with the prompt already filled in. | | Label | `Copy Prompt`, `Book using AI` or `Book using `. With `Book using `, the label names the assistant whose logo is showing. In **Specific assistant** mode, `Copy Prompt` becomes `Open in `. | | Assistants | In **Multiple assistants** mode: Cal.ai, ChatGPT, Claude, Grok, Perplexity, Muse, Instinct and OpenClaw. All are selected by default and at least one must stay selected. With more than one selected, the button rotates through their logos every five seconds. In **Specific assistant** mode, you choose one of Cal.ai, ChatGPT, Claude, Grok or Perplexity, the assistants that accept a prompt link. | ![Copy prompt button editor with the Embed theme dropdown, the Multiple assistants and Specific assistant cards, the Label dropdown, the list of assistant checkboxes, the HTML snippet and a live preview of the button](https://mintcdn.com/calcom/fk7_Xyrth54C39Nu/images/embed-events/copy-prompt-embed-editor.png?fit=max\&auto=format\&n=fk7_Xyrth54C39Nu\&q=85\&s=d172ee89bc32903d1372d9878ee204f6) The editor gives you HTML and React snippets; there is no React Atom snippet for this type. Both snippets are self-contained: they don't load the Cal.com embed script, so this embed fires none of the events on this page. They load the assistant logos as images from the Cal.com web app, for example `https://app.cal.com/ai-assistants/claude.svg`. With `Auto`, the HTML snippet switches colors with a `prefers-color-scheme` media query and the React snippet listens for changes with `matchMedia`. The button text on your website is always in English. ### Multiple assistants When a visitor clicks the button, it copies this prompt to their clipboard and shows the tooltip "Copied. Open your assistant and paste the instructions": ```text theme={null} If not added, add mcp.cal.com/mcp, then book / ``` The HTML snippet is a button with a short script that rotates the logos and copies the prompt. ### Specific assistant The button is a link that opens the chosen assistant in a new tab with the prompt in its chat box. Nothing is copied and no tooltip is shown. The HTML snippet is a plain link with no script. ChatGPT, Claude, Grok and Perplexity get the same prompt as in **Multiple assistants** mode. Cal.ai opens the [Cal.com assistant](https://cal.com/docs/agents.md#open-the-assistant-with-a-prompt-already-typed) on the **Home** page with `book /` typed in, because it already knows how to book on Cal.com. Visitors who aren't signed in are asked to sign in first and then see the prompt in the chat box. ![Copy prompt button editor in Specific assistant mode with the Dark theme, Cal.ai chosen from the radio list of Cal.ai, ChatGPT, Claude, Grok and Perplexity, and a dark preview button reading Open in Cal.ai](https://mintcdn.com/calcom/fk7_Xyrth54C39Nu/images/embed-events/copy-prompt-embed-specific-assistant.png?fit=max\&auto=format\&n=fk7_Xyrth54C39Nu\&q=85\&s=91f9ff6f826cf3bc482d00db6daa7924) If your booking page is on an organization or custom domain, or you self-host Cal.com, the copied prompt and the prefilled link contain the full booking URL instead of `/`. > [!NOTE] > > The Copy Prompt embed is only available for event types. The embed dialogs for routing forms and Cal Events don't offer it. ## Cal Event embed You can embed a published Cal Event on your website. To open the embed generator from the Events list, go to **Events**, open the `...` menu on the event's row, and select **Embed**. You can also select **Embed** in the event editor's header. ![Events list with the row menu of a published Cal Event open, showing Edit, Duplicate, View guests, Share event, Embed, Cancel event and Delete](https://mintcdn.com/calcom/W25CDaG29CGceCV5/images/embed-events/cal-events-list-embed-menu.png?fit=max\&auto=format\&n=W25CDaG29CGceCV5\&q=85\&s=8cfefe10ea42cb252fadc2a03d0d7d78) In the Events list, **Embed** is only listed for published events that haven't ended. It isn't listed for draft, past or cancelled events. Like the editor's **Embed** button, it's only shown on desktop-width screens. The generator uses the event's link and offers **Inline embed**, **Floating pop-up button** and **Pop up via element click**. It doesn't offer the Email or Copy Prompt embeds, or the **Hide link details** option. ![Embed dialog for a Cal Event opened from the Events list, showing the Inline embed, Floating pop-up button and Pop up via element click cards](https://mintcdn.com/calcom/W25CDaG29CGceCV5/images/embed-events/cal-event-embed-type-chooser.png?fit=max\&auto=format\&n=W25CDaG29CGceCV5\&q=85\&s=65c6cf150dea7ea7beb769424546a5da) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.