Skip to content

Add Sairo to your WordPress website.

Use Sairo’s JavaScript embed in a location your WordPress installation permits. This guide covers a script-based setup, not a dedicated Sairo plugin.

First-party product guidance. How we maintain these guides · Report a correction

Identify your WordPress hosting setup.

WordPress.com limits the code available on different plans. Its documentation allows JavaScript on plugin-enabled sites with the relevant hosting features activated. A free site’s HTML support does not imply that a third-party script can run.

For a self-hosted WordPress installation, check the permissions and code-insertion method supplied by your administrator or host. A page editor that displays code for readers is different from a location that executes a script.

Prepare the assistant before adding the code.

Add the published website origin to the correct Sairo workspace, verify ownership, and review the indexed sources. Prioritise service pages, contact information, and any policies a visitor is likely to ask about.

If an agency manages several WordPress sites, keep each client in the intended project. Copy the snippet from this site’s installation page so the key selects the right assistant.

Example only: replace the placeholder with the snippet from your workspace
<script src="https://sairo.app/widget.js" data-site="YOUR_PUBLIC_SITE_KEY" async></script>

Use one maintained insertion point.

Choose an approved header/footer insertion tool, an appropriate shared template location, or a developer-maintained theme integration. WordPress.com documents code blocks and plugin-based approaches according to plan capability.

For Sairo, place the generated snippet near the end of the page body where your chosen method supports it. Record where you installed it. Adding the same snippet through both a theme and an insertion tool can create confusing duplicate loads.

  1. Save the existing configuration

    Keep the original code or revision so the change can be undone without affecting other scripts.

  2. Add the site-specific snippet

    Retain its source URL, public site key, and async attribute.

  3. Publish and clear applicable caches

    Check the visitor-facing page rather than assuming the editor view reflects the installation.

Test with the theme and plugins visitors use.

Inspect a service page, a long page, and the narrow-screen layout. Confirm that the launcher does not cover a consent control, sticky call button, or form. Use a keyboard to open the panel, ask a question, and close it.

Ask a question supported by a source, one the site cannot answer, and one requesting a person. Use a contact address your team controls to test lead collection, then verify the record in the correct workspace.

If the launcher is missing, check the delivered page.

Check whether the published page contains the script, whether its request succeeds, and whether a consent manager or content security policy blocks it. If a performance plugin changes script loading, test that interaction in a controlled preview before changing the visitor experience.

When changing themes or moving hosts, check the insertion point again. The knowledge belongs to the configured Sairo site, but the website still needs to load the matching snippet.

Common questions

Can I paste the script into a code-display block?

A code-display block may show the snippet as text. Use an insertion method that permits JavaScript to execute and confirm the result on the published page.

Will changing my theme change the assistant?

It can remove a theme-specific insertion point. Check that the new theme still loads the correct Sairo snippet and that the widget works with the new layout.

See what your website can answer.

Try a sample, review the result, and decide what comes next.