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

# Install Darwin on Framer

> Add Darwin to your Framer site using Custom Code, publish it across your pages, and verify the chat experience.

Use Framer's project-level custom code to add Darwin across your published website. Darwin's floating chat sits above the page; it does not need a frame in your canvas.

## Before you start

You need access to Darwin's workspace settings and permission to edit custom code and publish your Framer project. Confirm custom code is available in your Framer plan.

## Add Darwin

<Steps>
  <Step title="Get your Darwin snippet">
    Open [Settings → Installation](https://app.meetdarwin.ai/admin/settings/installation) in the workspace you want to install.

    1. Under **Allow your website**, add the exact public hostname. `www.example.com` and `example.com` are separate hosts; add each one you actually use.
    2. Select **Copy** beside your workspace's embed code. Keep the complete snippet, including `async`, `data-site-key`, and `data-api-url`.

    Use your own snippet, not another workspace's code. If you also test on a staging domain, allow that hostname separately.
  </Step>

  <Step title="Create a custom script">
    In Framer, open **Project Settings → Custom Code**. Select **Add Script** or the **+** icon and name the entry **Darwin chat**.
  </Step>

  <Step title="Choose where it runs">
    Paste the complete snippet. Place it at the end of the body, select **All** pages, and choose **Once** so the loader is not added again on every internal navigation.

    Use project-level custom code instead of an Embed component inside a page. Keep the snippet's `async` attribute.
  </Step>

  <Step title="Publish to your domain">
    Save and publish the project. Test the public domain you allowed in Darwin. If you use a separate Framer preview hostname, add that hostname to Darwin before testing it.
  </Step>

  <Step title="Verify Darwin">
    Open the **published website** in a fresh browser session. Check the homepage and an inner page, then check a phone-sized screen.

    * The launcher appears once and opens your workspace's chat.
    * The assistant uses your saved appearance and opening message.
    * A question receives an answer from your assistant.
    * If you configured a scheduler, the booking flow opens correctly. Completing a live booking creates a real appointment and can count toward usage; use **Test chat** in Darwin for a simulated booking.

    Return to **Settings → Installation** and select **Check installation** or **Recheck installation**. If **Activate on my website** is available, finish that step too. Finding a script and activating a workspace are separate checks.

    If the widget is missing, follow [Widget not showing](/help/widget-not-showing). If only scheduling needs attention, use [Booking troubleshooting](/help/booking-troubleshooting).

    Also follow an internal page link and open the chat again. The launcher should remain usable without duplicate widgets. Check the reported page in Darwin after testing a new conversation.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The chat is trapped inside a page frame">
    Remove the Darwin Embed component and use **Project Settings → Custom Code**. The chat belongs to the website, not an iframe placed inside a canvas element.
  </Accordion>

  <Accordion title="The widget only appears on selected pages">
    Check the script's page scope. Select all pages for a site-wide installation, or keep a deliberate subset if that is where you want Darwin to appear.
  </Accordion>

  <Accordion title="It works on a direct load but not after navigation">
    Check for duplicate installations and confirm the custom script runs once. Test a published page rather than the editor canvas. If the problem continues, [contact support](/help/contact) with the starting URL and destination page.
  </Accordion>
</AccordionGroup>

## Update or remove Darwin

Change your assistant in Darwin. To uninstall it, remove the **Darwin chat** custom-code entry in Framer and publish the project again.

[Complete the launch checklist](/installation/launch-checklist) · [Darwin + Framer overview](https://www.meetdarwin.ai/integrations/framer)

<Accordion title="Platform reference">
  Custom-code placement and run settings were checked against [Framer's custom-code guide](https://www.framer.com/help/articles/how-to-add-custom-code/) on September 14, 2026.
</Accordion>