Contentsquare
Hi, how can we help?
Popular help topics: CS Live, Metrics List, Request an Integration

What's New? Releases & Updates How do I install the Contentsquare tag?

help center results

technical documentation

Français 日本語

Articles in this section

See more

Shopify App

What is the Shopify App?

The Contentsquare Shopify App is the recommended way to install Contentsquare on your Shopify store. It gives you full tracking coverage across your storefront and checkout pages and unlocks exclusive capabilities for Shopify Plus merchants.

Available capabilities by Shopify plan

  Shopify non-Plus Shopify Plus
On Storefront pages All Contentsquare capabilities All Contentsquare capabilities
On Checkout* pages
  • Pageview tracking
  • E-commerce events (requires Pro and Enterprise plans)

Same as non Plus, and:

  • Session Replay
  • Zoning and Heatmaps

*Checkout Pages include, Information, Shipping, Payment, Thanks and Order status.
 

E-commerce data collected on checkout

The app automatically tracks the following events at every step of the checkout process. This data is available for segmentation and filtering in your Contentsquare workspace (Pro and Enterprise plans):

orderID - Unique transaction identifier
amount - Transaction total
currency - Transaction currency code

How to implement the Shopify app on Contentsquare

Before you begin

You must be a Shopify administrator on your account.

Locate your Contentsquare ‘Tag ID’: in Contentsquare, go to the  Integration Catalog, search for Shopify, and copy the Tag ID number.

For existing customers

If you previously installed Contentsquare using a custom web pixel, remove it before proceeding to avoid duplicate data collection.

Shopify App Installation and Setup Guide

Step 1: Install and configure the app

  1. Install the Contentsquare app from the Shopify App Store.
  2. In the app, go to the ‘Contentsquare data collection’ section and fill in the following:
    • Tag ID: Paste the Tag ID (alphanumeric) from the Integration Catalog.
    • Data privacy contact: Enter an email address for privacy requests (required for compliance).
  3. Click ‘Save’.

Step 2: Map your domains to Contentsquare projects

After saving your connection code, a domain mapping table appears. This table lists all the active domains on your Shopify store, detected automatically from your Shopify Markets configuration.

Each domain in the table shows one of two statuses:

✅ Assigned  A Tag ID has been entered. Checkout data will be collected for this domain.
⚠️ Unassigned No Tag ID entered. Checkout data will not be collected for this domain.

To assign a Contentsquare project to each domain:

  1. Locate the domain in the table.
  2. In the 'Tag ID' field next to it, paste the Tag ID for the corresponding Contentsquare project.
  3. Repeat for each domain you want to track.
  4. Click 'Save'.

You can assign the same Tag ID to multiple domains if you want all of them tracked in the same Contentsquare project.

Reminder

  • Only domains configured as active markets in Shopify appear in the domain mapping table. Inactive markets and redirect-only domains are not listed.
  • The app checks that the Tag ID format is valid (alphanumeric), but does not verify it corresponds to an active Contentsquare project.
  • For Existing customers: If you already have the Shopify App installed with a single project, your current Tag ID is automatically pre-populated in all domain rows. You can update individual rows at any time.

Step 3: Enable Contentsquare on your pages

Note1: Already using a Tag Management System (TMS)? Skip this step if Contentsquare is already deployed via GTM or hard-coded on your storefront. If GTM is also active on checkout pages, exclude those URLs from your GTM implementation to avoid duplicate data collection.
Note2: If you are using a Pre-Online Store 2.0 themes, you are not able to use this tag installation method on your checkout pages. Please follow these manual instructions instead.
 

  1. Click ‘Add Contentsquare to storefront’.
  2. In the Shopify theme editor, click ‘Save’.
  3. Make sure Data masking is enabled on checkout pages (see below).
  4. Click ‘Enable data collection on checkout’ to start capturing pageviews on checkout pages. 
    This also enables Session Replay, Heatmaps, and Zoning Analysis for Shopify Plus merchants.

Data privacy and masking on Checkout pages

Checkout pages have different masking capabilities compared to storefront pages due to Shopify's secure checkout environment.

The Contentsquare tag automatically protects personal data on checkout pages through automated masking.

To prevent the collection of personal data on checkout pages, ensure page masking is applied to your checkout URLs. 

Important

Element masking does not work on Checkout pages when using the Shopify App.
If you have previously relied on Element Masking to protect sensitive data on other parts of your site, you cannot use the same approach on checkout pages. 

 

FAQs

I'm a Shopify Plus customer, using the custom pixel work around. Do I need to switch to the app?

Yes, you should switch to the Contentsquare Shopify app. Please note that you must uninstall the custom pixel workaround before installing the app to prevent duplicate data collection. Please read our installation guide.

I'm not on Shopify Plus. Can I upgrade to track checkout pages?

Yes! Upgrading to Shopify Plus will allow you to use the Contentsquare Shopify App and track the full checkout experience. Contact Shopify to learn more about upgrading your plan.

Does the app affect my website's performance?

No. The Contentsquare Shopify Tag is lightweight and optimized for performance. It runs in a secure sandbox and does not impact your pageviews load times or user experience.

Can I track multiple domains from one single Shopify store in different Contentsquare projects?

Yes. The Shopify App automatically detects all active domains on your store and lets you assign a different Tag ID to each one. 

Can I track multiple Shopify stores in the same Contentsquare project?

Yes. Install the Contentsquare Shopify App on each store and enter the same Tag ID during setup. Checkout data from all stores will flow into the same Contentsquare project.

What happens if I don't assign a Tag ID to all my domains?

Unassigned domains don't send data to Contentsquare. The app displays a warning whenever any domain is unassigned.

How do I find my Tag ID?

Go to the Integration Catalog in Contentsquare, search for Shopify, and copy the Tag ID number displayed.