Share consents across devices

Search…
Introduction
The Didomi CMP supports syncing to allow consent sharing across devices and environments. Consent can be shared between all environments that have syncing enabled in the same organization: multiple websites, multiple apps (same or multiple devices), multiple websites and apps together, etc.
When syncing is enabled and an organization user ID is available, the Didomi CMP will load the previously stored user choices from the Consents API and will apply them locally.
Syncing is currently in beta. Please reach out to our Support team ([email protected]) to enable the feature for your account.
Configuration
Setting user organization ID
For the sync process to work properly, a user.organizationUserId property needs to be set in the Didomi configuration object:
1
window.didomiConfig = {
2
  user: {
3
    organizationUserId: 'organization-user-id',
4
  }
5
};
Copied!
This value represents the unique identifier with which the organization identifies the user for which it wants to sync the consents. This can be an email address, a user ID, etc. We recommend hashing the value to not communicate plain user IDs to Didomi.
Enabling sync
The sync process can be enabled with async.enabled configuration option in the Didomi configuration object:
1
window.didomiConfig = {
2
  user: {
3
    organizationUserId: 'organization-user-id',
4
  },
5
  sync: {
6
    enabled: true
7
  }
8
};
Copied!
Behavior
Sync timeout
The maximum time allowed for the syncing process to be completed can be specified with a sync.timeout configuration option in the Didomi configuration object:
1
window.didomiConfig = {
2
  user: {
3
    organizationUserId: 'organization-user-id',
4
  },
5
  sync: {
6
    enabled: true,
7
    timeout: 2000
8
  }
9
};
Copied!
The sync.timeout configuration option accepts an integer which represents the maximum time allowed (in milliseconds) for the syncing process to be completed.
If the syncing process takes more time to be completed than it is specified in sync.timeout configuration option, the initialization continues as if there was no data to sync.
Delaying notice showing
The Didomi CMP enables delaying notice showing while the sync is in progress. This ensures that the user never sees the consent notice if sync is possible.
The sync.delayNotice configuration option can be used for delaying the notice showing until the sync is complete:
1
window.didomiConfig = {
2
  user: {
3
    organizationUserId: 'organization-user-id',
4
  },
5
  sync: {
6
    enabled: true,
7
    delayNotice: true
8
  }
9
};
Copied!
​
Share consents between domains
Custom domain
Last modified 5mo ago
Copy link
Contents
Introduction
Configuration
Setting user organization ID
Enabling sync
Behavior
Sync timeout
Delaying notice showing