Skip to main content

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. To add the tracker to your entire Framer site:
  1. Open your Framer project
  2. Click on the Settings icon (gear icon) in the top-right corner
  3. Scroll down to the Custom Code section
  4. Under Start of <head> tag, paste the CustomerOS tracker script
  5. Click Save

Option 2: Single Page Installation

To add the tracker to a specific page:
  1. Navigate to the page you want to track
  2. Click on the Settings option in the page’s menu
  3. Scroll to the Custom Code section
  4. Under Start of <head> tag, paste the CustomerOS tracker script
  5. 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:
  1. Visit your Framer site
  2. Open your browser’s developer console (F12 or right-click → Inspect)
  3. Check the Network tab for a request to your tracker domain
  4. Look for successful 200s and 202s from the tracker subdomain
  5. Check the Console tab for any errors
You should see page views appearing in your CustomerOS dashboard within a few minutes.
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
For more help, see our Troubleshooting guide.

Additional Resources

I