Add Databuddy's cookieless product analytics to your WordPress site with an asynchronous tracker. The tracker uses browser storage instead of analytics cookies. Review your privacy and consent configuration before enabling collection.

Installation methods

Choose one installation method. WordPress.com requires a plan that supports plugins and custom JavaScript; see its custom code requirements. Self-hosted WordPress supports the methods below.

Using a Plugin (Recommended)

The safest and easiest way to add Databuddy to WordPress is using a plugin that allows you to inject scripts without modifying theme files. Use a plugin-enabled WordPress.com plan or a self-hosted installation.

Install a script injection plugin

Install a plugin like Insert Headers and Footers from the WordPress plugin directory. This plugin lets you add scripts to your site's header or footer without touching theme files.

Add your Databuddy script

In the plugin settings, paste your Databuddy tracking script in the header section:

<script
src="https://cdn.databuddy.cc/databuddy.js"
data-client-id="YOUR_CLIENT_ID"
crossorigin="anonymous"
async
></script>

Save and verify

Save your changes and wait a few minutes, then check your Databuddy dashboard to confirm tracking is working.

Tip: If the script doesn't load in the header, try adding it to the footer section instead. Some WordPress configurations work better with scripts in the body.

Configuration options

Basic tracking setup

Enable essential tracking features for most WordPress sites:

<script
src="https://cdn.databuddy.cc/databuddy.js"
data-client-id="YOUR_CLIENT_ID"
data-track-hash-changes
crossorigin="anonymous"
async
></script>

Enhanced tracking setup

For more detailed analytics, enable additional tracking options:

<script
src="https://cdn.databuddy.cc/databuddy.js"
data-client-id="YOUR_CLIENT_ID"
data-track-attributes
data-track-outgoing-links
data-track-interactions
data-track-web-vitals
data-track-errors
crossorigin="anonymous"
async
></script>

WordPress-specific integrations

Form submission tracking

Track form submission attempts with a submit handler. To measure successful submissions, use your form plugin’s success callback instead:

<script>
document.addEventListener('submit', function (event) {
var form = event.target.closest('.wpcf7-form, .gform_wrapper form, .wpforms-form');
if (form && window.databuddy) {
  databuddy.track('form_submit', {
    form_id: form.id || 'unknown',
    page_path: window.location.pathname
  });
}
});
</script>

Performance benefits

Databuddy is designed to have minimal impact on your WordPress site's performance:

Asynchronous loading: Does not block HTML parsing; measure the script’s runtime impact
Core Web Vitals: Can collect field performance data when enabled

Common use cases

Membership sites

Track premium content engagement:

<button 
data-track="premium_content_view" 
data-content-type="video"
>
Watch Premium Video
</button>

Blog analytics

Track clicks anywhere inside an article (the data-track attribute fires on click, not on view):

<article 
data-track="article_click" 
data-category="tutorials" 
data-author="author-name"
>
<!-- Your article content -->
</article>

Lead generation

Track conversion events and CTA clicks:

<a 
href="/contact" 
data-track="cta_click" 
data-cta-type="contact"
>
Get Quote
</a>

Troubleshooting

Script not loading

If Databuddy isn't tracking:

Check the Network Tab: Open developer tools and confirm the script loads from cdn.databuddy.cc and requests are sent to basket.databuddy.cc
Verify Script Placement: Ensure the script is in the <head> or before </body>
Clear Cache: Clear your WordPress cache (WP Rocket, W3 Total Cache, etc.) and browser cache
Test in Incognito: Use incognito/private browsing to avoid cache issues

Plugin conflicts

If you're experiencing issues:

Temporarily deactivate other analytics plugins to identify conflicts
Check if your security plugin is blocking the script
Verify your theme includes wp_head() in header.php if using the functions.php method

Verification

After installation, verify tracking is working:

Visit your site and navigate through a few pages
Wait 2-3 minutes for data to process
Check your Databuddy dashboard for pageviews
Use browser dev tools Network tab to confirm requests are being sent

WordPress multisite

For WordPress multisite networks:

Individual Site Configuration: Add the Databuddy script to each site individually using one of the methods above
Unique Client IDs: Each site should have its own Client ID for separate analytics
Plugin Management: Consider using the Insert Headers and Footers plugin for easier management across multiple sites

For an end-to-end installation check, follow the WordPress analytics walkthrough. Once pageviews arrive, use the UTM campaign tracking guide to verify that a tagged visit and its conversion appear as expected.

Wix

Simple setup for Wix websites.

Squarespace

Code injection setup for Squarespace sites.

Webflow

Visual builder integration for Webflow sites.

Need help with your WordPress integration? Contact us at support@databuddy.cc.

WordPress

On this page