Consents and Preferences

This guide describes how the Didomi platform stores consent information and how you can implement the most common workflows through our Consents API.

The Consents API is subject to separate pricing from our CMP and Preference Center products. Please reach out to our Support team ( to get more information.


The Didomi platform is structured around the following concepts.


An end user that Didomi stores consent information on. A user is associated with a set of Didomi user IDs. When consent is collected through the Didomi SDKs, multiple users can actually be tied to a single real end user as Didomi IDs are stored in cookies and local storage so that it is practically a device ID.

You can associate a user with an organization user ID, which is a unique user ID that you can assign and that is used to link a Didomi user to your internal systems as well as resolve cross-platform IDs. It can be an email address, a phone number, a CRM ID, etc.

Additional metadata can also be associated with a user to track organization-specific information and apply specific rules.


Consents, as required by regulations like GDPR and CPRA, represent user authorizations for specific purposes and vendors, including cookie usage, marketing communications, etc... The Didomi platform ensures adaptation and compliance with diverse global legal requirements, safeguarding user data and privacy across different privacy laws.


In the Didomi platform, Preferences are more granular choices expressed by the user with respect to expressed consents. Those are used to add more details to consents and store more granular choices from users. Preferences can be associated with a list of channels and with specific metadata.

Preferences are always tied to a specific purpose. Examples:

  • The "cookies" purpose can be broken down into multiple categories: analytics, essential, marketing, social, etc.

  • The "marketing communications" purpose can be broken down into different types of communications (newsletter, special offers, etc.) and channels (email, text, etc.)

Entities and endpoints

The concepts presented above are represented, in the Didomi platform, with the following entities. Read on for more information on how to use the API for managing user consents.

  • Events: Consents given by end-users

  • Links: Pre-authenticated URLs to create consent events on the fly

  • Proofs: Proofs of consent associated with consent events

  • Secrets: Secrets used for authenticating public requests

  • Tokens: JWT tokens allowing end-users to access their consent data and update it

  • Users: End-users of your applications and websites that Didomi is storing consent information on

Last updated