Only users with Admin access can install and modify Tracking
settings.
Read-only for other users.
Introduction
The Contentsquare Tag is a configurable JavaScript snippet you install on your site to start collecting behavioral data and unlocking insights. For a broader understanding of how the tag integrates with your infrastructure, please review our Tag Implementation overview.
Access your tracking settings
If this is your first time accessing your account, you will be guided through a new onboarding flow designed to tailor the setup to your specific needs.
Note that only users with Admin rights can modify the Tracking settings.
To access the Tracking settings:
- Click on your profile icon.
- Click 'Projects and users'.
- Select 'Tracking' from the left hand menu.
Once you're in the Tracking settings, you'll find your Contentsquare tag details.
The Tag
The Contentsquare Tag is a configurable JavaScript snippet you install on your site to start collecting data.
In the Tag section you'll find your Tag ID: a 13-character identifier (for example, 216ef4cc18c26). The Tag ID is a unique identifier for your own dedicated Tag. It is tied to a unique project and embeds your Tag’s configuration in the script.
Tag installation methods
Choose the installation method that matches your setup:
- AI-assisted: Install the Tag on your website’s code with AI assistance
- Manual: Manually add the Tag to your website’s code
- Tag Managers: Choose the relevant Tag Manager to install the Tag
- Platforms: If your website is built upon Shopify or Salesforce’s platform
Install with AI-assistance
Best for: developers using AI coding assistants such as Cursor, Claude Code, or GitHub Copilot.
Requires Node.js ≥ 18
- Choose one of the following options:
- Wizard: Copy and run the command in your terminal. The wizard configures your AI agent, installs the tag for your framework, and verifies it's working.
- Using skills: Installing the skill pack will guide your AI coding agent through the Tag installation.
-
Manual prompt: Click to copy a pre-filled prompt into your AI coding assistant.
- Follow the instructions generated by your AI assistant to complete the installation.
- Once the change is live, return to Settings > Tag Installation and verify your installation.
Manually add the Tag to your website
Best for: developers and users with direct access to their site's code.
Before you start, check that your platform is compatible with Contentsquare: docs.contentsquare.com/en/web/compatibility
- In the Tag script section, click Copy. Your Tag ID is already included in the snippet, so you don't need to replace a placeholder.
- In your site's code, paste the tag between the opening and closing head tags on every page you want to track.
- Once the change is live, return to Settings > Tag Installation and verify your installation (see the verification steps below).
[Note]: Contentsquare works most accurately when the tag is placed inside the head tags of every page you want to track.
Install via Tag managers
Choose the relevant Tag Manager to install the Tag to your website.
Install via a platform
Read the relevant guide for Shopify or Salesforce in the Platform-specific installation guides section.
Send to a developer
Select 'Send to a developer' to email your Tag ID and installation instructions to anyone on your team.
Enter your developer's email address and click ‘Send’. They'll receive the installation instructions by email.
Verify your Tag installation
After installing the tag with the method of your choice, you can easily verify the proper install of the Tag on your website, using following our guide here.
Installation FAQs
Does Contentsquare track all your users?
Contentsquare captures the majority of user sessions, however it may not
be possible to capture 100% of all your site visitors.
A checklist to understand why not all traffic can possibly be captured:
Session targeting is in use: If you are targeting session capture based on specific events being triggered or URLs that are targeted, this will result in fewer sessions being collected.
Content Security Policies: If your website has a Content Security Policy, ensure it allows Contentsquare to operate. Otherwise, your site may block Contentsquare and prevent data collection.
User settings: A user's browser and/or local network environment can preventing session capture. This can include:
- A user's browser or network environment preventing session capture, such as unsupported browsers, JavaScript/cookies disabled, Do Not Track enabled, or private/incognito mode blocking tracking.
- The visitor has disabled localStorage or sessionStorage, or uses plugins, extensions, or privacy tools that block the Contentsquare tag.
- Accessing your site from a network that restricts Contentsquare's servers, blocks WebSocket connections, or experiences connectivity issues can prevent session capture.
How come the Tag is not capturing data?
Your tag is installed but it is not gathering any data. This may be due to
a Tag configuration issue. You might want to verify the installation of your
tag.
This could also be because no traffic has been recorded on your website in
the last 24 hours.
How do I know if the Contentsquare Tag is installed correctly?
You can verify the installation of your Tag to check it is working. For help with this, see our article on How do I check the Contentsquare tag installation is working?
Will Contentsquare slow down my site?
We prioritise site performance and do all that is possible to optimise every aspect of the process. Contentsquare makes every effort to ensure that the script downloads swiftly and does not block your page's loading time. The script is designed to minimise its impact on your site's performance. For more detail, see our article Will Contentsquare slow down my site?
What to read next?
How to check and manage data collection settings?
Platform-specific installation guides
Implementation Glossary