Overview
Framer allows you to add custom code to your website through the Custom Code settings. You can add the CustomerOS tracker to your entire site or to individual pages.Installation
Find the HTML Snippet in the CustomerOS app to add to your website. It is specific to your domain so that you aren’t blocked by adblockers and privacy modes.Option 1: Site-Wide Installation (Recommended)
To add the tracker to your entire Framer site:- Open your Framer project
- Click on the Settings icon (gear icon) in the top-right corner
- Scroll down to the Custom Code section
- Under Start of
<head>
tag, paste the CustomerOS tracker script - Click Save
Option 2: Single Page Installation
To add the tracker to a specific page:- Navigate to the page you want to track
- Click on the Settings option in the page’s menu
- Scroll to the Custom Code section
- Under Start of
<head>
tag, paste the CustomerOS tracker script - Click Save
For most use cases, we recommend site-wide installation to track visitors
across all pages of your website.
Verifying Installation
After adding the tracker script and publishing your site:- Visit your Framer site
- Open your browser’s developer console (F12 or right-click → Inspect)
- Check the Network tab for a request to your tracker domain
- Look for successful 200s and 202s from the tracker subdomain
- Check the Console tab for any errors
We automatically handle capturing information from form submissions in
Framer, you don’t need to do anything differently to capture this signal!
Troubleshooting
If the tracker isn’t working:- Ensure you’ve published your site (the tracker won’t work in preview mode)
- Check that your tracker domain is correct and accessible
- Verify that the script is in the Start of
<head>
tag section - Check the browser console for any JavaScript errors