> For the complete documentation index, see [llms.txt](https://docs.limecall.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.limecall.com/callback/install-on-wordpress.md).

# Install on WordPress

Three ways to add the widget to a WordPress site.

Pick whichever of these matches how your site is built. All three produce the same result.

## Option 1 — a header/footer plugin (recommended)

The safest method, because it survives theme updates.

1. In WordPress, go to **Plugins → Add New** and install a snippet plugin such as *WPCode* or *Insert Headers and Footers*.
2. Activate it, then open its settings.
3. Copy your snippet from **Widget → Embed** in LimeCall.
4. Paste it into the **Footer** box — not the header.
5. Save.

## Option 2 — your theme's built-in setting

Many themes include a custom-code area. Look under **Appearance → Customize** for "Custom Code", "Footer Scripts" or similar, and paste the snippet into the footer field.

{% hint style="warning" %}
Code pasted directly into a theme's own settings is usually lost when that theme updates. Option 1 avoids this.
{% endhint %}

## Option 3 — edit the theme directly

Only do this on a child theme. Editing a parent theme means losing your change on the next update.

1. Go to **Appearance → Theme File Editor**.
2. Open `footer.php`.
3. Paste the snippet immediately before `</body>`.
4. Update the file.

## Clear your cache

WordPress caching is the most common reason a correctly installed widget does not appear.

After installing, purge the cache in every layer you run:

* your caching plugin (WP Rocket, W3 Total Cache, LiteSpeed Cache, WP Super Cache),
* your host's server-side cache (Kinsta, WP Engine, SiteGround and others each have their own),
* Cloudflare or any other CDN in front of the site.

Then test in a private window.

## If you use an optimisation plugin

Plugins that combine, defer or minify JavaScript can break third-party widgets. If the widget does not load, add it to the exclusion list:

* **WP Rocket** — exclude `limecall` under *File Optimization → Excluded JavaScript Files*.
* **Autoptimize** — add `limecall` to *Exclude scripts from Autoptimize*.
* **LiteSpeed Cache** — add it to the JS Excludes list.

## Verify

Open your site in a private window and wait a few seconds for the widget to appear. If it does not, work through [The widget is not showing](/troubleshooting/widget-not-showing.md).