Shopify Integration
Add qvctrs to your Shopify store using the theme editor. Capture valuable e-commerce behavioral data.
Method 1: Theme Editor (Recommended)
Step 1: Access the theme editor
- From your Shopify admin, go to Online Store → Themes
- Click Actions → Edit code on your current theme
Step 2: Edit theme.liquid
- In the left sidebar, find Layout → theme.liquid
- Find the
</head>tag - 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>- 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:
- Go to Online Store → Themes
- Click Customize
- Go to Theme settings (gear icon)
- Look for "Custom scripts" or "Additional scripts"
- Paste the snippet and save
Method 3: Checkout Scripts (Plus Only)
For Shopify Plus merchants who want to track checkout behavior:
- Go to Settings → Checkout
- Scroll to Order status page → Additional scripts
- 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
- Visit your Shopify store
- Open Developer Tools → Console
- 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.