Microsoft Clarity Integration

As of October 31, 2025, Microsoft Clarity will require a valid consent signal for users from the European Economic Area (EEA), United Kingdom (UK), and Switzerland (CH).

This integration allows you to manage the Clarity tracking script via Efilli CMP and ensure that data is collected only after user consent.


Step-by-Step Setup Guide

1. Access the Design Editor

  • Log in to your Efilli panel

  • Click on “Domains” from the left-hand menu

  • Select the domain you want to configure

  • Click the “Design Editor” button on the domain card

  • Choose the banner layer you want to edit

If you have multiple language variants, repeat this step for each banner


2. Configure Microsoft Clarity Settings

  • Within the banner layer, go to “Banner Settings”

  • Select “Microsoft Clarity Settings”

  • A panel will appear with a toggle switch and two Clarity signals

  • Toggle the switch to “ON”

  • Match the signals as follows:

    • ad_storage → Marketing category

    • analytics_storage → Analytics category

This mapping is required for Efilli CMP to transmit consent status to Clarity.


3. Microsoft Clarity Panel Configuration

To complete the integration, adjust the settings in your Clarity account:

  • Log in to your Microsoft Clarity account

  • Go to the “Setup” section from the left menu

  • Locate the “Cookies” setting and switch it to “OFF”

This disables Clarity’s automatic cookie setup, ensuring cookies are only triggered after user consent via Efilli CMP.


4. Previously Installed Clarity Scripts

a. If Clarity was blocked by Efilli Efilli support will remove Clarity from the auto-blocking rules. Please contact support.

b. If Clarity was added via Google Tag Manager (GTM)

  • If Efilli has access to your GTM, we will remove the Clarity tag for you

  • If not, you must remove it manually from your GTM container

Remove the “Microsoft Clarity” tag and any triggers to prevent duplicate loads


5. Verify the Integration

Use the following steps to confirm that consent signals are working properly:

  1. Open your website in a browser without giving consent

  2. Open the browser console and run:

Expected output:

  1. Give consent via the Efilli banner, then run the same command again:

If these values appear correctly, the integration is working as expected.


6. Known Issue: GraphQL Error

You may occasionally see a “GraphQL Error” in Clarity. This is not caused by Efilli and typically resolves by refreshing the page or re-logging into your account.


Once these steps are complete, Microsoft Clarity will only begin tracking after valid user consent is given through your Efilli CMP banner.

Last updated