> ## Documentation Index
> Fetch the complete documentation index at: https://docs.customeros.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Framer

> Install the CustomerOS tracker on your Framer website

## 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:

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

<Note>
  For most use cases, we recommend site-wide installation to track visitors
  across all pages of your website.
</Note>

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

<Tip>
  We automatically handle capturing information from form submissions in
  Framer, you don't need to do anything differently to capture this signal!
</Tip>

## 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](/tracker/troubleshooting).

## Additional Resources

* [Framer Custom Code Documentation](https://www.framer.com/academy/lessons/custom-code)
* [Custom Events Tracking](/tracker/custom-events)
* [Website Tracker Overview](/tracker)
