BlogPricingDashboardGitHubGitHub★ 841

Squarespace

Add Databuddy's privacy-first analytics to your Squarespace website using Squarespace's Code Injection feature.

How to Add Databuddy to Squarespace

1

Get Your Tracking Script

Get your Databuddy tracking script from your Databuddy dashboard. It will look like this:

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

Replace YOUR_CLIENT_ID with your actual Client ID from your Databuddy dashboard.

2

Go to Squarespace Settings

Log in to your Squarespace account and select the website you want to track.

From the main dashboard (Home Menu), navigate to Settings.

3

Access Code Injection

In the Settings panel, find and click on:

  • Website (under the "GENERAL" section)
  • Then, click on Code Injection (under the "ADVANCED" or "DEVELOPER" section, depending on your Squarespace version)
4

Paste Your Tracking Script

In the Code Injection settings, you'll see several fields (Header, Footer, Lock Page, Order Confirmation Page).

For sitewide tracking, paste your Databuddy tracking script into the Footer text area. This ensures the script loads after your page content, which is better for perceived page load performance.

Alternatively, you can place it in the Header, which might track users who leave before the page fully loads, but could slightly impact initial page load speed. For most analytics purposes, the Footer is recommended.

5

Save Changes

After pasting the script, click the Save button at the top of the Code Injection panel.

6

Verify Integration

Once you've saved the changes, Databuddy should start tracking visitors on your Squarespace site.

  • Open your Squarespace website in a new browser tab or incognito window
  • Navigate through a few pages
  • Check your Databuddy dashboard for incoming data. It might take a few minutes for the first events to appear

Configuration Options

Enable additional tracking features by adding data attributes to your script tag:

html
<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-performance
data-track-web-vitals
data-track-errors
data-track-scroll-depth
async
></script>

Custom Event Tracking in Squarespace

Track custom events by adding JavaScript code through Code Injection or using Squarespace's built-in code blocks.

Using Data Attributes

Enable automatic tracking with data attributes:

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

Then add data-track attributes directly to elements in your Squarespace content:

html
<!-- Button with automatic tracking -->
<button data-track="cta_click" data-button-type="primary">
Get Started
</button>

<!-- Link with tracking -->
<a href="/pricing" data-track="pricing_link_click" data-link-location="header">
View Pricing
</a>

Tracking Button Clicks

Add custom JavaScript to track specific button interactions:

html
<script type="text/javascript">
document.addEventListener('DOMContentLoaded', function() {
var button = document.getElementById('your-button-id');
if (button && window.databuddy) {
  button.addEventListener('click', function() {
    window.databuddy.track('button_click', {
      button_id: 'your-button-id',
      button_text: button.textContent || button.innerText,
      page_path: window.location.pathname
    });
  });
}
});
</script>

Tracking Form Submissions

Track form submissions from Squarespace forms:

html
<script type="text/javascript">
document.addEventListener('DOMContentLoaded', function() {
var forms = document.querySelectorAll('form[data-form-type]');
forms.forEach(function(form) {
  if (window.databuddy) {
    form.addEventListener('submit', function() {
      window.databuddy.track('form_submit', {
        form_type: form.getAttribute('data-form-type') || 'contact',
        page_path: window.location.pathname
      });
    });
  }
});
});
</script>

Common Use Cases

E-commerce Tracking

Track product views and purchases on Squarespace Commerce sites:

javascript
// Track product view
if (window.databuddy) {
window.databuddy.track('product_view', {
  product_id: 'product-123',
  product_name: 'Example Product',
  price: 29.99
});
}

// Track add to cart
window.databuddy.track('add_to_cart', {
product_id: 'product-123',
quantity: 1
});

Newsletter Signups

Track newsletter subscriptions:

javascript
document.addEventListener('DOMContentLoaded', function() {
var newsletterForm = document.querySelector('form[data-form-type="newsletter"]');
if (newsletterForm && window.databuddy) {
  newsletterForm.addEventListener('submit', function() {
    window.databuddy.track('newsletter_signup', {
      form_location: 'footer',
      page_path: window.location.pathname
    });
  });
}
});

Blog Engagement

Track blog post views and reading engagement:

javascript
document.addEventListener('DOMContentLoaded', function() {
if (window.databuddy && window.location.pathname.includes('/blog/')) {
  window.databuddy.track('blog_post_view', {
    post_title: document.title,
    page_path: window.location.pathname
  });
}
});

Troubleshooting

Script Not Loading

  • Verify the script is in the Footer section of Code Injection
  • Check browser console for errors
  • Ensure your Client ID is correct
  • Confirm you have a Squarespace Business or Commerce plan
  • Clear browser cache and reload

Events Not Tracking

  • Confirm window.databuddy exists before calling tracking methods
  • Check that elements exist before attaching event listeners
  • Use DOMContentLoaded to ensure DOM is ready
  • Verify events appear in your Databuddy dashboard after 2-3 minutes
  • Check browser dev tools Network tab to confirm requests are being sent

Squarespace-Specific Issues

  • Some Squarespace templates may load content dynamically
  • Use DOMContentLoaded or setTimeout for timing-sensitive tracking
  • Test in different browsers and devices
  • Ensure Code Injection is enabled for your plan

Verification Steps

After installation, verify tracking is working:

  1. Visit your Squarespace site and navigate through a few pages
  2. Wait 2-3 minutes for data to process
  3. Check your Databuddy dashboard for page views
  4. Use browser dev tools Network tab to confirm requests are being sent
  5. Test in incognito mode to avoid cache issues

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

How is this guide?

Edit on GitHub