How to Embed a Chatbot on Weebly (2026 Guide)

Step-by-step instructions to add a chatbot to Weebly — which plans allow custom code, how to go site-wide via Header Code or per-page via the Embed Code element, and how to fix common display issues.

Which Weebly plans allow custom code embedding?

Weebly's Header Code and Footer Code fields are available on paid plans only — the free tier does not allow site-wide script injection. The Embed Code drag-and-drop element is similarly restricted; on free sites, any custom HTML you add is stripped out on publish.

The table below shows what each plan allows. If you are on the free plan and need a working chatbot immediately, jump to the hosted-page fallback section at the end of this guide.

Weebly plan custom code support (2026)
PlanHeader/Footer CodeEmbed Code elementCSS editor
FreeNoNo (stripped on publish)No
PersonalYesYesLimited
ProfessionalYesYesYes (Edit HTML/CSS)
PerformanceYesYesYes (Edit HTML/CSS)

Weebly is now owned by Square, and new sites created through Square may use the Square Online editor rather than classic Weebly. The menu paths in this guide apply to classic Weebly. If your dashboard looks different — with a left-side panel labeled "Website" and a section called "Online Store" — you are on Square Online, which has different settings locations. See the Square Online note later in this guide.

How do you add a chatbot site-wide via Weebly Header Code?

The fastest path to a site-wide chatbot on Weebly is the Header Code field in the SEO settings panel. A script tag placed here loads on every page of your published site without touching individual page layouts.

  1. 1

    Log in and open your site editor

    Go to weebly.com, log in, and click Edit on the site you want to modify. This opens the drag-and-drop editing canvas.

  2. 2

    Click Settings in the top navigation bar

    Settings is one of the tabs running across the top of the Weebly editor (alongside Build, Pages, Theme, Store, and Apps). Click it to open the settings panel.

  3. 3

    Select SEO from the Settings submenu

    Inside Settings, click the SEO tab on the left side. Scroll down until you see the Header Code and Footer Code text areas.

  4. 4

    Paste your script tag into the Header Code field

    Place your chatbot script tag — for example, <script src="https://www.knobot.org/widget.js" data-key="YOUR_KEY" async></script> — into the Header Code text area. This field accepts any valid HTML, including <script> tags.

  5. 5

    Click Save in the top-right corner

    After pasting, click the Save button. Weebly saves the code to your site configuration, but it does not go live until you publish.

  6. 6

    Click Publish

    Click the orange Publish button in the top-right corner of the editor. Weebly deploys your changes. Once published, the chatbot will load on every page of your live site.

  7. 7

    Test on the live URL, not the editor preview

    Open your published site in a new browser tab. The Weebly editor canvas does not execute third-party scripts — the chatbot will show only as a grey placeholder box inside the editor. Confirm the chat bubble appears on your live site and send a test message.

How do you add a chatbot to a single Weebly page using the Embed Code element?

If you want the chatbot on specific pages rather than everywhere, Weebly's Embed Code element lets you drop a custom HTML block onto any individual page. This approach is also useful as a fallback if you prefer not to touch the SEO settings panel.

One important caveat: the Embed Code element is designed for inline page content, not floating widgets. Because the chatbot widget positions itself as a fixed overlay (bottom-right corner), it will appear correctly on the live site regardless of where you place the Embed Code element on the page. Place it at the bottom of the page to keep the editor canvas tidy.

  1. 1

    Open the page you want to edit

    In the Weebly editor, click the Pages tab and select the page where you want the chatbot to appear.

  2. 2

    Find the Embed Code element in the Build panel

    Click the Build tab at the top of the editor. In the left-side elements panel, locate the Embed Code element — it is listed under the "Basic" or "More" section depending on your plan. Drag it onto the page canvas, placing it near the bottom of the page.

  3. 3

    Click "Edit Custom HTML"

    Click the Embed Code block you just added. A prompt appears: "Click to add custom HTML". Click it to open the code editor box.

  4. 4

    Paste your chatbot script tag

    Paste your full script tag into the code editor. For Knobot, this is: <script src="https://www.knobot.org/widget.js" data-key="YOUR_KEY" async></script>

  5. 5

    Click outside the box to commit

    Click anywhere outside the code editor box to save the HTML. The element will show a grey placeholder in the editor canvas — this is normal. The actual widget only renders on the published live site.

  6. 6

    Publish and verify

    Click Publish. Open the specific page on your live site to confirm the chatbot appears.

How do you embed Knobot on Weebly specifically?

Knobot uses a single <script> tag with a data-key attribute — there is no plugin to install and no Weebly App Center integration required. Knobot's Premium plan at $79/month covers 10,000 messages per month with no per-conversation overage fees. A 14-day trial with 100 free preview messages is available before you commit.

  1. 1

    Create a Knobot account

    Sign up at knobot.org. After creating your business profile, Knobot scrapes your website using RAG (retrieval-augmented generation with Voyage embeddings and Gemini Flash 2.5) to build the initial knowledge base. No manual Q&A writing required.

  2. 2

    Customize the widget

    In the Knobot dashboard, set your primary color, welcome message, and lead-capture fields (name, email, phone number). These settings sync to the live widget automatically — you do not need to re-embed the script when you make changes.

  3. 3

    Add your Weebly domain under Widget → Install

    In the Knobot dashboard, go to Widget → Install and add your exact published domain (both apex and www variants, e.g., yourbusiness.com and www.yourbusiness.com). This authorizes the widget to load on your domain.

  4. 4

    Copy the embed snippet

    On the same Widget → Install screen, copy the script tag. It will look like: <script src="https://www.knobot.org/widget.js" data-key="YOUR_KEY" async></script>

  5. 5

    Paste into Weebly Header Code and publish

    Follow the site-wide steps above: Settings → SEO → Header Code. Paste the snippet, click Save, then click Publish.

  6. 6

    Test lead capture on the live site

    Open your live Weebly site, trigger the chatbot, and submit a test lead. Confirm the lead appears in the Knobot dashboard under Conversations. Check that the email notification (if configured) arrives in your inbox.

What is the difference between Weebly classic and Square Online for embedding?

Square acquired Weebly in 2018. Since then, Square has been migrating users to Square Online — a separate website builder that shares the Square ecosystem but uses a different interface and different settings structure. The platform your site runs on determines which embed path to follow.

Weebly classic vs Square Online — embed path comparison
Classic WeeblySquare Online
Site-wide script injectionSettings → SEO → Header CodeWebsite → Pages → [page] → Settings → Advanced (varies by plan)
Per-page custom HTMLEmbed Code drag-and-drop elementCode Block (HTML) content section
Custom code plan requirementPersonal plan or aboveFree plan may be restricted; higher tiers required for head scripts
Editor preview shows widgetNo — grey placeholder onlyNo — preview does not execute scripts

If you are on Square Online and find that head-script access is locked to a higher plan tier, the Knobot hosted page (described below) is the cleanest alternative — no embedding required.

What should you do if the chatbot does not appear after publishing?

If you have published your Weebly site but the chatbot widget is not visible, work through these causes in order — they cover the vast majority of cases.

How do you fix z-index conflicts between the chatbot and Weebly themes?

Some Weebly themes assign high z-index values to sticky navigation bars, promotional banners, or cookie notice overlays. When these sit above the chatbot widget in the stacking order, the chat button becomes unreachable — it renders behind the other element.

To fix this, add a CSS override using Weebly's HTML/CSS editor (available on Professional and Performance plans under Theme → Edit HTML/CSS). Add the following to your custom CSS:

[data-knobot-widget] {
  z-index: 99999 !important;
}

Knobot's widget wrapper uses the data-knobot-widget attribute as its root selector. If you are using a different chatbot provider, replace the selector with the class or attribute that provider uses. After saving, publish the site and verify on the live URL.

Does Weebly's SSL or CSP block third-party chatbot scripts?

Weebly enforces HTTPS on all hosted sites, which means your chatbot vendor must also serve assets over HTTPS. A script tag pointing to an HTTP URL will be blocked by the browser as mixed content — a browser-level restriction, not something Weebly enforces. Knobot serves widget.js over HTTPS by default, so this is not a concern.

Content Security Policy headers instruct the browser to block scripts from sources not listed in the policy. Weebly does not apply a restrictive CSP on standard hosted sites — pasting a script tag into Header Code works without any policy modification. If you have a custom domain running through a third-party proxy or CDN that injects its own security headers, check that the proxy's CSP script-src directive allows www.knobot.org. For the vast majority of Weebly users on standard hosting, CSP is not a factor.

What is the alternative if your Weebly plan does not allow custom code?

If you are on the free Weebly plan, or on Square Online without head-script access, you still have a working option: the Knobot hosted chat page. Every Knobot account gets a dedicated URL at knobot.org/c/your-business that requires no embedding — it is a standalone page you can share as a link or QR code.

Frequently asked questions

Which Weebly plan do I need to embed a chatbot?

Access to the Header Code field (Settings → SEO → Header Code) requires a paid Weebly plan — Personal, Professional, or Performance. The free Weebly plan does not include custom header or footer code injection. The drag-and-drop Embed Code element is available on paid plans as well; free sites have it disabled or stripped on publish. If you are on the free plan, the hosted Knobot page at knobot.org/c/your-business is the no-code alternative.

Why does my chatbot appear in the Weebly editor but not on the live site?

The opposite is more common: the Embed Code element shows only a placeholder grey box in the Weebly editor. Third-party scripts do not execute inside the drag-and-drop editing canvas. Always click Publish and test on your real live URL — not the editor preview — to confirm the widget renders. If the widget appeared in the editor but not on the live site, check that you published after pasting the code and that your plan supports custom code.

Does embedding a chatbot work the same way on Square Online as on classic Weebly?

No. Classic Weebly sites use Settings → SEO → Header Code for site-wide scripts and the Embed Code drag-and-drop element for per-page placement. Square Online (the newer platform Weebly migrated to) stores header scripts in a different location — typically under Website → Pages → Settings for a specific page, or under Website → Store settings. Square Online also restricts head-script access to higher-tier plans. If your dashboard looks like Square Online rather than classic Weebly, the menu paths in this guide will differ.

Can I put the chatbot on only one Weebly page instead of site-wide?

Yes. Use the Embed Code element (the drag-and-drop custom HTML block) and place it only on the pages where you want the chatbot to appear. Drag the Embed Code element onto a page, click Edit Custom HTML, paste your script tag, and click outside to commit. Publish the site. The script runs only on pages that contain the element. The Header Code field in Settings → SEO is site-wide only.

Will Weebly block my chatbot script as a security measure?

Weebly does not apply a restrictive Content Security Policy on standard hosted sites, so a properly formed HTTPS script tag embeds without issue. The main technical requirement is that your chatbot vendor serves the widget over HTTPS — any HTTP asset will be blocked by the browser as mixed content. Knobot serves widget.js over HTTPS by default. No CSP configuration is needed on the Weebly side.

The chatbot widget is hidden behind other Weebly elements — how do I fix it?

This is a z-index conflict. Weebly themes sometimes use high z-index values for sticky headers, cookie banners, or promotional bars. To push the chatbot above them, add a CSS override. In the Weebly editor, go to Design → Edit HTML/CSS (available on Professional and Performance plans), and add: [data-knobot-widget] { z-index: 99999 !important; } — replacing the selector with whatever class or attribute your chatbot widget uses.

Do I need to re-paste the script if I update my chatbot settings?

No. The script tag contains only your unique data-key identifier. Any changes you make in the Knobot dashboard — welcome message, lead-capture fields, color, knowledge base — are fetched at runtime when a visitor loads the widget. You paste the script tag once and never need to update it unless you switch to a different business key.

Sources