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
- How to add the code to Framer
- How to check the installation
- How to troubleshoot the installation
Copy your Tidio code
- Log in to your Tidio panel.
- Go to Settings > Live Chat > Installation.
- Choose Manual install.
- 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>
Add the code to Framer
- Open Project Settings in your Framer project.
- Select Custom Code in the left sidebar.
- Click Add Script for your first script. If you already have custom code, click the + icon instead.
- Give the script a name such as Tidio chat.
- Choose placement at the end of the
<body>tag. - Set Pages to All for a site-wide installation.
- Choose Once rather than Run on every page visit.
- Paste the complete Tidio script into the custom code entry.
- 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 for script entries and run settings. Its site optimization guide 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 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_KEYwith 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.
