# Install Tidio on Lovable

Section: Install Tidio

Description: Add Tidio to your Lovable site with a prompt or a manual script edit, connect the documentation, and check the published widget.

Verified against Tidio panel 12.331.0

Last updated: 2026-11-18

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

Add the Tidio chat widget to your Lovable site with one prompt, or edit the code yourself. New Lovable projects use TanStack Start and older ones use React with Vite. The script goes in a different file in each, and the prompt below covers both.

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

- [How to find your Public key](https://help.tidio.com/articles/install-lovable/#public-key)
- [How to ask Lovable to add the widget](https://help.tidio.com/articles/install-lovable/#prompt)
- [How to add the script yourself](https://help.tidio.com/articles/install-lovable/#manual)
- [How to give Lovable the Tidio documentation](https://help.tidio.com/articles/install-lovable/#docs-for-ai)
- [How to check the installation](https://help.tidio.com/articles/install-lovable/#check)
- [How to troubleshoot the installation](https://help.tidio.com/articles/install-lovable/#troubleshooting)

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

Silent walkthrough. Open Developer settings and select your project's Public key.

## Find your Public key

Log in to your Tidio panel and go to **Settings > Developer > Project data**. Click the **Public key** field to select its value, then copy it.

![The Project data page with the Public key field, masked private key and Visit widget SDK documentation button visible](https://help.tidio.com/article-media/install-lovable/project-data-public-key.png)

The Public key is part of the script address that every visitor's browser loads, so you can keep it in front-end code. The private key on the same page is different: never put it in your website.

You'll find the same key inside the installation code in **Settings > Live Chat > Installation**, under **Manual install**:

```
<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-lovable/installation-manual-install.png)

## Ask Lovable to add the widget

Replace ` YOUR_PUBLIC_KEY ` in this prompt with your Public key, then send it in your project's chat. Lovable changes code in Build mode, which is active unless you switched to Chat mode or Plan mode.

```
Add the Tidio live chat widget to this project.

1. Load this script once on every page, at the end of the body, with async:
   <script src="//code.tidio.co/YOUR_PUBLIC_KEY.js" async></script>
2. Put it in the root route file for a TanStack Start project, or index.html in the project root for an older React + Vite project, so it loads once and stays loaded during client-side navigation. Do not add it to single pages or to a component that mounts more than once.
3. Do not install an npm package for Tidio. The script tag is the whole installation.
4. Do not use window.tidioChatApi on the server. Use it only in the browser, after the "tidioChat-ready" event fires on document.
5. Change nothing else, then tell me which file you edited.

Reference: https://help.tidio.com/articles/install-ai-coding-agents/
```

Use the [TanStack Start installation guide](https://help.tidio.com/articles/install-tanstack-start/) for Lovable's current default stack, or the [React installation guide](https://help.tidio.com/articles/install-react/) for older React with Vite projects. If you do not know your project's stack, ask Lovable: ` What stack is this project on? `

When the change is ready, click **Publish** in the top right of the editor. For a new site, review the proposed address and click **Publish** again. For an existing live site, click **Publish changes**. Test the published URL, not just the preview.

## Add the script yourself

Open Lovable's **Code** tab to browse the project files. You need edit access to the project to open the code editor, and a paid plan to edit and save files. On the Free plan the editor is read-only, so use the prompt above instead.

For an older React with Vite project that has ` index.html ` in the project root:

1. Open **Code** and select ` index.html `.
2. Find the closing ` </body> ` tag. Add this script immediately before it, replacing ` YOUR_PUBLIC_KEY ` with your Public key. Keep the existing page content and scripts.

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

Click **Save**, then publish the change. Do not add this tag if the prompt already installed it.

For more detail on older projects, follow [Install Tidio on React](https://help.tidio.com/articles/install-react/). For a TanStack Start project, follow [Install Tidio on TanStack Start](https://help.tidio.com/articles/install-tanstack-start/) to edit the root route instead. Do not create an ` index.html ` file for that approach.

## Give Lovable the Tidio documentation

### Add project instructions

Open **Project settings > Instructions** and add these two lines to **Project instructions**. Lovable includes project instructions as context when you send messages:

```
Keep the Tidio widget script loaded once in the root HTML document or root layout, never in individual pages or repeatedly mounted components. Do not add an npm package for Tidio.
Before changing the Tidio integration, consult https://help.tidio.com/llms.txt and https://developers.tidio.com/llms.txt for the help center and Widget SDK documentation.
```

### Connect the documentation through MCP

Lovable connects to remote MCP servers as chat connectors on all plans, unless your workspace admin has disabled them. The connector gives Lovable the documentation while it builds. It does not install the widget in your published app.

1. Open **Connectors**, select **Add custom**, then choose **MCP server**.
2. Enter ` Tidio documentation ` as the **Server name**.
3. If a **Connection** dropdown appears, keep **Direct connection**.
4. Enter ` https://help.tidio.com/mcp ` as the **Server URL**.
5. Choose **No authentication**, then click **Add server**.

The Tidio documentation server is read-only and needs no login. Ask Lovable to use the Tidio documentation connector to find the installation guide for your project's framework before editing the integration.

See Lovable's [custom MCP documentation](https://docs.lovable.dev/integrations/custom-mcp) if the connector option is unavailable.

## 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**.

## Troubleshoot the installation

- If the published site has not changed, click **Publish**, then **Publish changes**. Saving code does not update the live site.
- If the widget does not load, check that you replaced ` YOUR_PUBLIC_KEY ` with the Public key, not the private key.
- If you see two widgets or duplicate script requests, ask Lovable to find every reference to ` code.tidio.co ` and keep one installation in the root document or layout.
- If a TanStack Start page fails during server rendering, check that code using ` window ` or ` document ` runs only in the browser.
- If your site uses a Content Security Policy, allow Tidio's hosts. The ` script-src ` directive needs ` code.tidio.co `. The [Content Security Policy](https://developers.tidio.com/docs/widget-security-policy) page of the developer documentation has the full list.
- If an automated check cannot see the widget, check the published site in a regular browser window.

## Further reading

- [Install Tidio on React](https://help.tidio.com/articles/install-react/)
- [Install Tidio on TanStack Start](https://help.tidio.com/articles/install-tanstack-start/)
- [Install Tidio with an AI coding agent](https://help.tidio.com/articles/install-ai-coding-agents/)
- [Widget SDK](https://help.tidio.com/articles/widget-sdk/)
