For the complete documentation index, see llms.txt. This page is also available as Markdown.

Share end-user consent across multiple domains

Didomi supports sharing end-user consent across multiple domains via a "group cookies" configuration that is stored and shared from a sub-domain that is delegated to Didomi. In this article, we will cover the following requirements to enable this configuration:


Prerequisites

Before continuing with the configuration to share end-user consent across multiple domains, your organization will need a subdomain that you own which is then delegated to Didomi. This delegated domain is then used to store and share end-user consent across configured websites.

Considerations

When implementing the methodology included in this article, be aware of the following changes and/or limitations to your implementation:

Third-party cookie limitations

The methodology included in this article is dependent on browsers accepting third-party cookies. More browsers, by default, are blocking the use of third-party cookies. Therefore, end-users browsing with default settings on Safari, Firefox, or Chrome on iOS, or end-users who have blocked third-party cookies, will not be able to store third-party cookies in their browser. Didomi will fall back to using first-party cookies when third-party cookies are not available.

Switching from first-party cookies

If you organization is already using Didomi with first-party cookies (the default behavior) and decide to switch to third-party cookies, the consent notice will be displayed to all visitors again to recollect consent.

Load time

Sharing consent between domains increases the load time of the SDK as it involves additional asynchronous operations for reading and writing consent from a different domain.

When sharing end-user consent across domains your organization will need to inform its end-users via the consent notice. The following information should be included in the consent notice:

  • Statement that end-user consent is shared across multiple websites

  • List of websites and legal entities where end-user consent is shared

To edit the content of an existing consent notice, click Consent notices on the left-hand panel and select the Edit icon inline with a consent notice name.

Click the Customization tab and select to the Content editor sub-tab on the subsequent page.

Navigate to the appropriate layer where your organization plans to inform the end-user about consent sharing and use the text field in the editor to include the information.

If your organization uses different consent notices for the websites that will share the end-user consent, then you must include the text informing end-users of the sharing to each of those consent notices.

With the consent notice updated to inform end-users of consent being shred across domains, your organization will need to update the consent notice configuration to indicate that the consent notice is using group cookies and from where the end-user's consent is stored and shared.

Review the tabs below to learn more about how to enable group cookies from either the Didomi console or directly on page:

From the consent notice, click Advanced settings in the upper right-hand corner and select Custom JSON from the drop-down menu.

Use the subsequent field to enable group cookies and to input the delegated domain that will be used to store and share the end-user consent cookie.

Click Save when finished.

Publish your consent notice.

If your organization uses different consent notices for the websites that will share the end-user consent, then you must enable group cookies for each of those consent notices.

Last updated