# Install Tidio on Framer

Section: Install Tidio

Description: Add Tidio as a site-wide custom script in Framer, choose when it runs, and check the chat widget on your published site.

Verified against Tidio panel 12.331.0

Last updated: 2026-11-18

Source: https://help.tidio.com/articles/install-framer/

Add Tidio to your Framer site with a site-wide custom script. Set the script to run once so you do not add another widget on every page visit. You do not need a package for Tidio.

**In this article, you'll learn:**

- [How to copy your Tidio code](https://help.tidio.com/articles/install-framer/#copy-code)
- [How to add the code to Framer](https://help.tidio.com/articles/install-framer/#install)
- [How to check the installation](https://help.tidio.com/articles/install-framer/#check)
- [How to troubleshoot the installation](https://help.tidio.com/articles/install-framer/#troubleshooting)

[Video](https://help.tidio.com/article-media/install-framer/walkthrough.mp4)

Silent walkthrough. Opening Settings > Live Chat > Installation, choosing Manual install and copying the code snippet.

## Copy your Tidio code

1. Log in to your Tidio panel.
2. Go to **Settings > Live Chat > Installation**.
3. Choose **Manual install**.
4. Click **Copy to clipboard**.

Your code has this form. Use the code you copied, or replace ` YOUR_PUBLIC_KEY ` with your project's Public key:

```
<script src="//code.tidio.co/YOUR_PUBLIC_KEY.js" async></script>
```

![Settings > Live Chat > Installation with Manual install selected, the code snippet visible, and the Copy to clipboard button.](https://help.tidio.com/article-media/install-framer/installation-manual-install.png)

## Add the code to Framer

1. Open **Project Settings** in your Framer project.
2. Select **Custom Code** in the left sidebar.
3. Click **Add Script** for your first script. If you already have custom code, click the **+** icon instead.
4. Give the script a name such as Tidio chat.
5. Choose placement at the end of the ` <body> ` tag.
6. Set **Pages** to **All** for a site-wide installation.
7. Choose **Once** rather than **Run on every page visit**.
8. Paste the complete Tidio script into the custom code entry.
9. Click **Publish** at the top right of the editor to publish your changes.

Keep one Tidio custom code entry for the whole site. Do not add a second copy to individual pages.

Framer's **Once** option adds and executes the code a single time. The other option executes it each time someone visits the page.

See Framer's [custom code guide](https://www.framer.com/help/articles/how-to-add-custom-code/) for script entries and run settings. Its [site optimization guide](https://www.framer.com/help/articles/site-optimization/) describes site-wide custom code and end-of-body placement.

## Check the installation

Open your site in a regular browser window. The chat widget appears in the corner of the page and stays there when you move between pages. Headless and automated browsers may not show the widget, so do not rely on them for this check.

Loading a page with the widget is what activates it. After that, **Settings > Live Chat > Installation** in your Tidio panel says **Chat Widget is installed properly**.

Check the published site after publishing your Framer changes.

## Troubleshooting

- If the widget does not appear across your site, check the custom code entry's page selection. Use **Pages** set to **All**, not a selection of individual pages.
- If you pasted the script into page content, move it to the project-level **Custom Code** entry. Paste the whole script, including its opening and closing tags.
- If the published site has not changed, publish your latest changes and open the site again. See [Framer's publishing guide](https://www.framer.com/help/articles/publishing-your-framer-website/) for the publishing steps.
- If you see two widgets or duplicate script requests, remove duplicate Tidio entries. Check that the remaining entry uses **Once**, not **Run on every page visit**.
- If the widget does not load, check the script address. Replace ` YOUR_PUBLIC_KEY ` with the Public key for the Tidio project you want to use.
- If an automated browser does not show the widget, repeat the check in a regular browser window on the published site.

## Further reading

- [Install Tidio on your website](https://help.tidio.com/articles/install-website/)
- [Customize your chat widget](https://help.tidio.com/articles/customize-widget/)
- [Uninstall Tidio](https://help.tidio.com/articles/uninstall-tidio/)
