qv

Webflow Integration

Add qvctrs to Webflow using the custom code feature. Works on all Webflow plans that support custom code.

Easiest1 minute

Method 1: Site-wide (Recommended)

Add qvctrs to all pages on your Webflow site:

Step 1: Open Site Settings

  1. In your Webflow project, click the W menu (top left)
  2. Select Site settings
  3. Go to the Custom Code tab

Step 2: Add the snippet

  1. In the Head code section, paste:
<!-- qvctrs SDK -->
<script>
window.qvctrs=window.qvctrs||{};window.qvctrs.q=window.qvctrs.q||[];
window.qvctrs.init=window.qvctrs.init||function(){window.qvctrs.q.push(['init'].concat(Array.prototype.slice.call(arguments)))};
window.qvctrs.init({siteId:'YOUR_SITE_ID'});
</script>
<script src="https://www.qvctrs.com/qvctrs-sdk-v2.js" async></script>
  1. Click Save Changes
  2. Publish your site
Screenshot: Webflow Site Settings → Custom Code → Head code

Method 2: Page-specific

Add qvctrs to specific pages only:

  1. Open the page in the Webflow Designer
  2. Click the gear icon (Page settings) in the top right
  3. Scroll to Custom Code
  4. Paste the snippet in Inside <head> tag
  5. Save and publish

Method 3: Webflow Embed Element

You can also use an Embed element, though this is less recommended as it loads later in the page lifecycle:

  1. Add an Embed element to your page
  2. Paste the snippet
  3. Position it at the top of your page structure
  4. Make it invisible (width: 0, height: 0)

Webflow Ecommerce

For Webflow Ecommerce sites, the qvctrs SDK automatically captures shopping behaviors:

  • Product page viewing patterns
  • Add to cart interactions
  • Checkout form behavior
  • Collection browsing

Webflow Memberships

For sites with Webflow Memberships, the SDK respects gated content — it only tracks interactions on pages the user can access.

Verify Installation

  1. Publish your Webflow site
  2. Visit the published site (not the webflow.io preview)
  3. Open Developer Tools → Console
  4. Run window.qvctrs.version — should show "2.4.0"

Checklist

  • ✓Snippet added to Site settings → Custom Code → Head code
  • ✓Site ID replaced with your actual ID
  • ✓Site published (not just saved)
  • ✓Verified on published site (not webflow.io preview)

Troubleshooting

Script works in Designer preview but not on published site

Make sure you click Publish after adding the custom code. Just saving isn't enough — the site must be republished.

Custom code option not available

Custom code requires a paid Webflow site plan (Basic or above). The free Starter plan doesn't support custom code injection.

Testing on staging

If you have a staging subdomain, you can test there first. The qvctrs SDK works on any domain — just make sure the domain is registered in your dashboard.