Framer

Databuddy enables you to gather privacy-first analytics on user behavior, capture custom events, track performance metrics, and more within your Framer site - all while maintaining GDPR compliance without cookies.

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.setAttribute("data-client-id", "YOUR_CLIENT_ID");
  script.setAttribute("data-track-screen-views", "true");
  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 Console tab for a "Databuddy initialized" message
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

Track custom interactions in your Framer components using data attributes:

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

<!-- Track form submissions -->
<form data-track="newsletter_signup" data-form-location="header">
<!-- form content -->
</form>

Performance Monitoring

Enable performance tracking by updating your script configuration:

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

Benefits for Framer Sites

Cookie-free tracking: No cookie consent banners needed
Lightweight: Under 30 KB script size (far smaller than Google Analytics)
True privacy: No fingerprinting, complete data ownership
Fast Loading: Async loading won't slow down your Framer site
SEO Friendly: Improves Core Web Vitals and page speed scores
Privacy Compliant: Fully GDPR and CCPA compliant
Real-time Data: See visitor activity as it happens
10x more efficient: Better for the planet, better for performance
Open Source: Fully transparent and auditable 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 your domain is verified in Databuddy dashboard
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 help@databuddy.cc.