> ## 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 WordPress

> Install Darwin AI chat on WordPress with a site-wide script, then check your domain, caching, and live chat.

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

<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="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </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).
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="WordPress removes the script when I save">
    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](https://wordpress.com/support/code/).
  </Accordion>

  <Accordion title="It works when I am logged in, but visitors cannot see it">
    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.
  </Accordion>

  <Accordion title="It only appears on one page">
    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.
  </Accordion>
</AccordionGroup>

## 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](/installation/launch-checklist) · [Darwin + WordPress overview](https://www.meetdarwin.ai/integrations/wordpress)

<Accordion title="Platform references">
  These steps were checked on September 14, 2026 against WordPress.com's [header and footer code guide](https://wordpress.com/support/adding-code-to-headers/) and [JavaScript requirements](https://wordpress.com/support/code/). Self-hosted WordPress permissions depend on your site's configuration.
</Accordion>