Skip to main content
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

1

Get your Darwin snippet

Open 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.
2

Create a custom script

In Framer, open Project Settings → Custom Code. Select Add Script or the + icon and name the entry Darwin chat.
3

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.
4

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.
5

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. If only scheduling needs attention, use 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.

​
Troubleshooting

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.
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.
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 with the starting URL and destination page.

​
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 · Darwin + Framer overview
Custom-code placement and run settings were checked against Framer’s custom-code guide on September 14, 2026.