> For the complete documentation index, see [llms.txt](https://docs.didomi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.didomi.io/regulations-manager/frameworks/microsoft-consent-mode/microsoft-consent-mode-tcf.md).

# Microsoft Consent Mode (TCF)

{% hint style="success" %}
**Access Type**: Regulations Manager - Editor
{% endhint %}

Microsoft Consent Mode is a framework that ensures Microsoft Advertising Universal Event Tracking (UET) tags comply with an end-user's consent choices. In this article, we will cover how to utilize the IAB TCF integration with Microsoft Consent Mode.

* [Microsoft Consent Mode (TCF) overview](#microsoft-consent-mode-tcf-overview)
* [Implement Microsoft Consent Mode (TCF)](#implement-microsoft-consent-mode-tcf)

{% hint style="warning" %}
**Note**: Didomi only supports adding Microsoft Consent Mode (Advanced) as a framework to regulations that utilize vendor as a data collection scope and for websites only.
{% endhint %}

***

### Microsoft Consent Mode (TCF) overview

When your organization leverages the IAB TCF integration with Microsoft Consent Mode, the Didomi web SDK will not push a default consent or update consent call to `window.uetq`. Instead, Didomi will write the end-user's consent decisions to the TC string and expose it so that the UET tag can read whether the end-user has provided consent to the vendor Microsoft Advertising (IAB Vendor ID: `1126`) and all of its required purposes.

The status for `ad_storage` will be set based on the end-user's decision for Microsoft Advertising (IAB Vendor ID: `1126`) and all of its required purposes as recorded in the TC String.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FgFgl3vMZUnvbCyZ4vSHd%2FUET%20TCF%20Diagram-selection.png?alt=media&amp;token=2345bfac-df05-4555-98a3-8b3939b6d6b2" alt="" width="563"><figcaption></figcaption></figure>

### Implement Microsoft Consent Mode (TCF)

In order to successfully implement Microsoft Consent Mode (TCF) for the regulation, your organization must configure the following:

* [Enable Microsoft Consent Mode (TCF) for regulation](#enable-microsoft-consent-mode-tcf-for-regulation)
* [Configure UET tag](#configure-uet-tag)

#### Enable Microsoft Consent Mode (TCF) for regulation

Click **Regulations Manager** on the left-hand panel.&#x20;

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2F1KJmegU3PNHxYs5LL50W%2FScreenshot%202026-09-28%20at%2012.52.45%E2%80%AFPM.png?alt=media&amp;token=e8075a8a-69c6-4686-a7d4-6b840a877bf0" alt="" width="563"><figcaption></figcaption></figure>

Navigate to a regulation that utilizes a data collection scope by vendor on the subsequent table and click the **Edit** icon inline with the regulation name.&#x20;

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FlNcEMAmC8rYph2L3x7hC%2FScreenshot%202026-09-28%20at%201.08.53%E2%80%AFPM.png?alt=media&amp;token=44c900f3-ad63-40a1-bd51-6bc1671d759c" alt="" width="563"><figcaption></figcaption></figure>

Navigate to the **Frameworks** card on the **Global Settings** page. Ensure that **IAB TCF** and **Microsoft Consent Mode** is enabled.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FguoZzRkl4mNPhcy0fGa3%2FScreenshot%202026-10-02%20at%202.30.08%E2%80%AFPM.png?alt=media&amp;token=d3300f10-387c-4b30-9ca9-56da81380faa" alt="" width="563"><figcaption></figcaption></figure>

By enabling the Microsoft Consent Mode framework for the regulation, Didomi will automatically add the following vendor to the regulation:

* Microsoft Advertising (API ID: `microsoft-6zPzfpLt`)

Navigate to the **Vendors & Purposes** tab and use the provided vendor x purpose matrix to configure processing rules, remove one of the purposes, etc... for Microsoft Advertising (API ID: `microsoft-6zPzfpLt`). See [Configure regulation (by vendor)](https://docs.didomi.io/regulations-manager/manage-regulations/configure-regulation-by-vendor.md#vendors-and-purposes) for more information.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FhLloWzse2OJX07Btnpvz%2FScreenshot%202026-09-29%20at%206.52.45%E2%80%AFAM.png?alt=media&amp;token=f58e22a1-951f-4e60-97d3-1e2cce9dc139" alt="" width="563"><figcaption></figcaption></figure>

Finally, navigate to the **Frameworks** tab and expand the **Microsoft Consent Mode** accordion to configure any details of the framework.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FB6Cc3RYr9EV8vbJg8scF%2FScreenshot%202026-09-29%20at%206.58.18%E2%80%AFAM.png?alt=media&amp;token=0e3d383d-3f80-47bd-b214-b676a8dd787e" alt="" width="563"><figcaption></figcaption></figure>

Review the table below for information on each toggle in the integration configuration:

<table><thead><tr><th width="295.0001220703125">Toggle</th><th>Description</th></tr></thead><tbody><tr><td>Set the default status of Microsoft Consent mode when page loads</td><td><p>Will set a default consent status for <code>ad_storage</code> prior to the end-user making a consent choice. Unless otherwise configured, the default of this setting is <code>denied</code>.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Note</strong>: This toggle can be <strong>deactivated</strong> since the DIdomi web SDK will not set a default when utilizing the IAB TCF integration with Microsoft Consent Mode.</p></div></td></tr><tr><td>Enable <code>ad_storage</code> before user gives consent</td><td><p>Will set the default of <code>ad_storage</code> to <code>granted</code> before end-user provides consent choice.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Note</strong>: This toggle can be <strong>deactivated</strong> since the DIdomi web SDK will not set a default when utilizing the IAB TCF integration with Microsoft Consent Mode.</p></div></td></tr><tr><td>Enable IAB TCF integration with Microsoft Consent Mode</td><td>Ensure this toggle is <strong>activated</strong> to enable the IAB integration with Microsoft Consent Mode.</td></tr></tbody></table>

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FLXsRypuuO92saxdoV8Qd%2FScreenshot%202026-10-02%20at%203.02.45%E2%80%AFPM.png?alt=media&amp;token=68aab41e-fae7-4598-89b9-2266ceb215c0" alt="" width="563"><figcaption></figcaption></figure>

Click **Save** when finished to confirm the edits to the regulation.

#### Configure UET tag

Since Microsoft Consent Mode relies on the TC String to control the status of `ad_storage` when utilizing the IAB TCF integration, your organization can implement the UET tag as it normally would.ysh


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.didomi.io/regulations-manager/frameworks/microsoft-consent-mode/microsoft-consent-mode-tcf.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
