Track visits, custom events, errors, and performance on your Framer site. Databuddy uses browser storage instead of analytics cookies; review your privacy and consent configuration before enabling collection.

Easy Setup: Install our official Framer plugin from the Framer Marketplace for the fastest setup, or manually add the script using the instructions below.

Installation Methods

Option 1: Framer Plugin (Recommended)

The easiest way to add Databuddy to your Framer site is through our official plugin:

Install the Plugin

Open your Framer project
Go to Plugins in the left sidebar
Search for "Databuddy Analytics"
Click Install on the Databuddy Analytics plugin

Configure Settings

Enter your Client ID from your Databuddy dashboard
Configure optional settings:
- Custom CDN URL (for self-hosted setups)
- Custom Dashboard URL (for self-hosted setups)

Publish Your Site

Click Publish to make your changes live.

Plugin Benefits:

Zero configuration needed
Automatic updates
Self-hosted option available
No manual code editing required

Plugin created by Dominik Koch

Option 2: Manual Installation

If you prefer manual control or need custom configuration:

Get Your Tracking Script

Navigate to your Databuddy dashboard and copy your tracking code snippet:

<script>
(function () {
  var script = document.createElement("script");
  script.async = true;
  script.src = "https://cdn.databuddy.cc/databuddy.js";
  script.crossOrigin = "anonymous";
  script.setAttribute("data-client-id", "YOUR_CLIENT_ID");
  script.setAttribute("data-track-attributes", "true");
  script.setAttribute("data-track-errors", "true");
  document.head.appendChild(script);
})();
</script>

Add the Script to Your Framer Project

Open your Framer project
Go to Site Settings > General
Scroll down to Custom Code
Paste your Databuddy snippet into the Start of <head> tag section
Click Save and publish your changes

Verify Installation

Once published, you can verify that Databuddy is working by:

Visiting your live Framer site
Opening your browser's developer tools (F12)
Checking the Network tab for a request to basket.databuddy.cc
Visiting your Databuddy dashboard to see real-time analytics

If you see real-time data in your dashboard, congratulations! Databuddy is now tracking your Framer site analytics.

Advanced Features

Custom Event Tracking

With data-track-attributes="true" enabled, track clicks using data attributes:

<!-- Track button clicks -->
<button data-track="cta_clicked" data-button-type="primary">Get Started</button>

Performance Monitoring

Replace your existing manual script with this configuration to enable performance tracking. Install the tracker once:

<script>
(function () {
  var script = document.createElement("script");
  script.async = true;
  script.src = "https://cdn.databuddy.cc/databuddy.js";
  script.crossOrigin = "anonymous";
  script.setAttribute("data-client-id", "YOUR_CLIENT_ID");
	script.setAttribute("data-track-web-vitals", "true");
  script.setAttribute("data-track-errors", "true");
  document.head.appendChild(script);
})();
</script>

Benefits for Framer Sites

Cookieless collection: Browser storage, with opt-out and optional identification controls
Performance visibility: Collect Core Web Vitals when enabled
Real-time data: See recent visitor activity
Open source: Inspect and self-host the code

Troubleshooting

Plugin Issues

If the plugin isn't working:

Ensure you've entered the correct Client ID
Verify your site is published (not just preview mode)
Check that the plugin is enabled in your Framer project settings
For self-hosted setups, verify your CDN and Dashboard URLs are correct

Script Not Loading

If Databuddy isn't working:

Ensure the script is in the Start of <head> tag section
Check that your Client ID is correct
Verify your site is published (not just preview mode)
Check browser console for any error messages

Data Not Appearing

If analytics data isn't showing:

Wait 2-3 minutes for data processing
Check that the hostname registered for your website matches your published site
Ensure you're viewing the correct date range
Try visiting your site in an incognito window

Webflow

Visual builder integration for Webflow sites.

Bubble

No-code integration for Bubble applications.

Wix

Simple setup for Wix websites.

Need help? Contact our support team at support@databuddy.cc.

Framer