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: Just 3KB script size (247x 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
Related Integrations
Visual builder integration for Webflow sites.
No-code integration for Bubble applications.
Simple setup for Wix websites.
Need help? Contact our support team at help@databuddy.cc.
How is this guide?