Think Build Implement Repeat
London, UK +44 7367 067226
WhatsApp FOLLOW f in X
  1. Home
  2. Blog
  3. Installing SpideyChat Outside the Usual Platforms
AI Chatbots

Installing SpideyChat Outside the Usual Platforms

Where a chatbot script goes in Webflow, React, Next.js and static sites, plus content security policies and what to check after you deploy it.

Updated 2 min readBy SpiderHunts Technologies

Free estimateNo obligation

Get a free estimate

Tell us what you need. A senior engineer reads every enquiry.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →

Quick answer — TL;DR

Webflow takes it in project settings before the closing body tag. React and Next.js want it in the root layout or document, loaded after hydration. Static sites take it in the template footer.

Webflow

Project Settings, Custom Code, Footer Code. Paste the script and republish. It then appears on every page of the site.

For a single page only, use that page's own settings instead of the project-level field.

React and Next.js

  • Next.js app router: in the root layout, loaded after interactive
  • Next.js pages router: in the custom document, before the closing body
  • Plain React: in the index HTML, or injected once on mount
  • Load it lazily — never as part of the initial bundle
The mistake in single-page applications is loading the widget on every route change. Load it once and let it persist; otherwise conversations reset when the user navigates.

Static sites and generators

Astro, Hugo, Eleventy, Jekyll and hand-built HTML all take the same approach: put the script in the shared layout template, before the closing body tag.

One edit covers the whole site because the template is shared.

Content security policies

If your site sends a content security policy header, the widget's domain needs allowing for scripts and connections. Otherwise it silently fails to load.

That is the most common cause of “it works locally and not in production” with any third-party widget.

Check it after deploying

  1. Open the live site in a private window
  2. Confirm the widget appears and opens
  3. Ask it one real question
  4. Check the browser console for blocked requests

FAQ

Frequently asked questions

The questions readers ask us after this guide.

Still have a question?

Ask us directly — a senior engineer will get back to you.

Ask about your project

Does it affect our build?

No. It is a runtime script tag, not a dependency.

Will it hurt our performance scores?

Loaded lazily after the main content, the effect is minimal. Loaded in the head, it will show.

Can we control when it appears?

Yes — inject it conditionally based on route or user state if you want it on some pages only.

What about server-side rendering?

The widget is client-side only. Guard against it running during server render in frameworks that would attempt it.

Keep reading

More on AI Chatbots

AI Chatbots

From Nothing to a Working Chat Assistant

Setting up SpideyChat in an afternoon: create the bot, describe your business, crawl your site, test your top twenty questions and install it.

AI Chatbots

What the Crawler Learns, and What It Misses

Training a chatbot on your website content: what the crawler reads well, what it misses in forms, images and PDFs, and why outdated pages mislead it.

Start here

Custom site and no time for an integration project?

One script tag is the whole installation. Start at spideychat.com.

  1. You tell us what you needTwo minutes on the form, or a message on WhatsApp.
  2. A senior engineer reviews itAnd comes back with questions, a realistic range and an honest view on fit.
  3. Free 30-minute scoping callWe talk through scope, options and a realistic estimate — with no obligation.
Free estimateNo obligation

Talk to someone who builds this

Send a short brief and we will come back with an honest view and a realistic range.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →