Fix Microsoft Clarity Not Connecting to Google Tag Manager
Question details
The user is unable to integrate Microsoft Clarity with Google Tag Manager. Despite trying direct integration, GTM templates, and manual installation, the connection fails, and Clarity subsequently shows an error stating that the tag is already installed.
- Product
- Microsoft Clarity
- Device & OS
- not provided
- Scenario
- Attempting to deploy Microsoft Clarity tracking code on a website using Google Tag Manager.
- Observed behavior
- Integration methods fail, and Clarity incorrectly reports that a tracking tag already exists, preventing successful data connection.
Ensure you have full administrative access to both your Microsoft Clarity project and the respective Google Tag Manager container before attempting to modify the tracking tags.
Clear Duplicate Tags and Reintegrate via GTM
Remove any existing hidden or duplicate Clarity tags in your Google Tag Manager workspace before running a fresh integration to clear the 'tag already exists' error.
Often, earlier attempts at manual installation or using a GTM template leave residual code behind. Clarity detects this snippet and blocks new direct integrations to prevent duplicate tracking.
Log into your Google Tag Manager account, select your container, and click on the 'Tags' menu on the left sidebar.
Search for any Custom HTML tags or Clarity template tags that contain your Clarity project ID. Select them and click the trash can icon to delete them.
Click 'Submit' in the top right corner of Google Tag Manager to publish the changes and clear the old tags from your live environment.
Go to your Microsoft Clarity dashboard, navigate to Settings > Setup, choose the Google Tag Manager integration, and follow the on-screen prompts to authenticate.
Escalate to the Appropriate Support Channels
If standard troubleshooting fails, the issue must be redirected to dedicated Microsoft webmaster tools support, as general Microsoft 365 forums cannot resolve Clarity backend errors.
Boost Your Productivity with WPS Office
While you troubleshoot website analytics and tracking tags, keep your daily workflow running smoothly. WPS Office is a powerful, lightweight, and free alternative to Microsoft Office that is perfect for drafting SEO reports and webmaster documentation.
- 1. Download WPS Office: Visit the official WPS Office website and click on the Free Download button.
- 2. Install the Application: Run the installer file and follow the standard on-screen instructions to set up the software.
- 3. Start Creating: Open WPS Office to immediately start editing your Word, Excel, PowerPoint, and PDF files.

Frequently Asked Questions
Why does Microsoft Clarity say my tag already exists?
This usually happens if a Clarity tracking code was previously added manually to your website's source code, or if there is a duplicate tag hidden inside a Custom HTML tag within your Google Tag Manager container.
Can I install Microsoft Clarity without Google Tag Manager?
Yes, you can manually install the Clarity tracking code. Copy the JavaScript snippet provided in the Clarity Setup page and paste it directly into the <head> section of your website's HTML.
How long does it take for Clarity to show data after connecting?
After successfully integrating Microsoft Clarity with Google Tag Manager and publishing your workspace, it typically takes up to 2 hours for session recordings and heatmaps to start processing and appearing in your dashboard.




