Skip to main content
Add Darwin once through a site-wide script manager. You do not need a separate Darwin plugin or a chat block on every page.

​
Before you start

  • You can manage Darwin’s workspace settings and publish changes to WordPress.
  • Your WordPress installation allows custom JavaScript. For WordPress.com, use a plan that supports plugins and script code.
  • You have access to your site’s approved header/footer script tool. The steps below use WPCode, the Insert Headers and Footers plugin referenced by WordPress.com. If your team already uses another tool, use its equivalent site-wide footer field.

​
Install the embed

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

Open the site-wide script settings

In WordPress, open Code Snippets → Header & Footer in WPCode. If your site does not have an approved script tool yet, ask its administrator to install and activate one.
3

Save Darwin in the footer

Paste the complete snippet into Footer, keeping any existing scripts. Select Save Changes. The embed should apply across the site, rather than to one post or a Custom HTML block.Keep the opening and closing script tags. Do not paste the snippet into a PHP-only field.
4

Refresh the published site

If a caching plugin, host cache, or CDN serves an older page, clear the affected page cache using your site’s normal process. Open the public domain while signed out of WordPress.
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.

​
Troubleshooting

Your account or hosting plan may restrict JavaScript. Check the site’s script permissions and use the approved script manager. WordPress.com explains its code restrictions.
Check the public page cache and any snippet rules that limit the script to administrators. A consent manager or script-delay setting may also postpone loading. Apply your site’s consent rules consistently rather than disabling them.
Move the snippet from the individual page or post into the site-wide footer setting. Remove the old copy so it is not loaded twice.

​
Update or remove Darwin

Manage the chat’s appearance and answers in Darwin. To remove it from WordPress, remove its snippet from the script tool and clear any affected page cache. Keep other scripts intact. Complete the launch checklist · Darwin + WordPress overview
These steps were checked on September 14, 2026 against WordPress.com’s header and footer code guide and JavaScript requirements. Self-hosted WordPress permissions depend on your site’s configuration.