Shopify Integration

Add qvctrs to your Shopify store using the theme editor. Capture valuable e-commerce behavioral data.

Easy2 minutes

Method 1: Theme Editor (Recommended)

Step 1: Access the theme editor

  1. From your Shopify admin, go to Online Store → Themes
  2. Click Actions → Edit code on your current theme

Step 2: Edit theme.liquid

  1. In the left sidebar, find Layout → theme.liquid
  2. Find the </head> tag
  3. Paste the qvctrs snippet just before it:
<!-- 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>
</head>
  1. Click Save

Shopify 2.0 Themes

In Shopify 2.0 themes (Dawn, etc.), the file may be called theme.liquid or you might need to check sections/header.liquid.

Method 2: Shopify Settings

Some themes support adding scripts via theme settings:

  1. Go to Online Store → Themes
  2. Click Customize
  3. Go to Theme settings (gear icon)
  4. Look for "Custom scripts" or "Additional scripts"
  5. Paste the snippet and save

Method 3: Checkout Scripts (Plus Only)

For Shopify Plus merchants who want to track checkout behavior:

  1. Go to Settings → Checkout
  2. Scroll to Order status page → Additional scripts
  3. Paste the snippet

Checkout Limitations

Standard Shopify plans have limited access to checkout customization. The SDK will still capture all pre-checkout behavior.

E-commerce Data Captured

The qvctrs SDK automatically detects Shopify and captures rich e-commerce behavioral signals:

Product Browsing

  • • Product view duration
  • • Image gallery interactions
  • • Variant selection patterns
  • • Size guide usage

Shopping Behavior

  • • Add to cart hesitations
  • • Comparison shopping (A-B-A)
  • • Wishlist interactions
  • • Quick view usage

Cart & Checkout

  • • Cart review time
  • • Form field struggles
  • • Shipping option deliberation
  • • Abandonment signals

Navigation

  • • Collection browsing
  • • Filter/sort usage
  • • Search behavior
  • • Menu exploration

Verify Installation

  1. Visit your Shopify store
  2. Open Developer Tools → Console
  3. Run window.qvctrs.version — should show "2.4.0"

Checklist

  • Snippet added to theme.liquid before </head>
  • Site ID replaced with your actual ID
  • Theme saved and published
  • Verified in browser console

Troubleshooting

Script appears in page source but doesn't run

Check if you have any Shopify apps that modify script loading or add content security policies.

Theme backup

Before editing theme.liquid, click Actions → Duplicate to create a backup of your theme.