1.80.0 (November 17, 2022)

  • Remove TCF v1 support.
  • Supporting url and resource name from logoUrl configuration parameter.

1.79.1 (October 24, 2022)

  • Fix transparent background for fullscreen notices on older iOS version (below 14.0).

1.79.0 (October 20, 2022)

  • Fix transparent Notice background for older iOS version (below 14.0).
  • Fix some text colors for darker background color.
  • Fix missing device disclosure url for some Vendors.

1.78.0 (September 16, 2022)

  • Add ability to enable sticky buttons on the notice (see Sticky Buttons).
  • Disable location query from device GPS when the location permissions are granted (we now rely only on our API to get the user location and to provide the matching regulation).
  • Update link to IAB TCF v2 from the vendor detail page.

1.77.0 (September 13, 2022)

  • Add support for CCPA
CCPA support is still in beta, please contact [email protected] if you are interested to participate

1.76.0 (September 8, 2022)

  • Improve how texts scale based on the device settings.
  • Improved accessibility on buttons displayed on the notice.
  • Consent asked events was using all required purposes as both consent and legitimate interest.

1.75.0 (August 25, 2022)

  • Improve accessibility of close buttons and headings on Preferences screens.
  • Reduce tvOS SDK size by removing unnecessary classes.

1.74.0 (August 8, 2022)

  • Simplify Vendors button from Purpose list page.
  • Add ability to enable fullscreen mode (see Fullscreen mode for more details).
  • Handle device storage disclosure as link (instead of json) from IAB vendor list.
  • Improve accessibility of Preferences screen.

1.73.0 (July 21, 2022)

  • Query purposes for current language in order to always provide up-to-date translations.
  • Add new events for language change (see Events for more details).
updateSelectedLanguage is now asynchronous.
  • Disable neutral state when controlled value is legitimate interest.
  • setUserAgreeToAll and setUserDisagreeToAll methods were not thread safe which could have caused crashes if called concurrently from multiple threads.

1.72.0 (June 27, 2022)

  • Handle mutli-account for Cross-device feature (see Multi-account for more details).
  • Allow to customize font family of title and description in notice and preferences screen (see Custom Font Family for more details).
  • Hide bulk action in purposes and vendors screens when there is only one item in the list.
  • Allow to call reset() method while SDK is not initialized.

1.71.2 (June 16, 2022)

  • Add an optional title field in notice (seeTexts for more details)
  • Allow to customize font size, color and alignment of title and description in notice and preferences screen (seenotice, preferences for more details)
Bug fixes:
  • Improve device storage disclosure screens transitions

1.70.0 (Mai 17, 2022)

Bug fixes:
  • Fix wrong background for Vendors detail screens.

1.69.0 (April 27, 2022)

  • Update design for tablets.
  • Improve accessibility for Vendor detail and Purpose detail screen.
  • Add new languages support (Norwegian, Brazilian, Azerbaijani, Bengali, Filipino/Tagalog, Hebrew, Hindi, Indonesian, Macedonian, Swahili).
New languages must be enabled from the Console once they are available.
Bug fixes:
  • Disable neutral state for legitimate interest from the Vendor detail screen.
  • Improve accessibility of preferences screen and purpose and vendor details screens

1.68.0 (April 4, 2022)

  • tvOS: Display Disagree button on TV notice only when it is requested in configuration.
For the moment, TV notice configurations generated by the console always display the Disagree button. To remove it, it has to be specified using custom json, as described here.
  • Support removeEventListener method.
Bug fixes:
  • Italic HTML tags not taken into account for notice and preferences text.
  • Fix "seconds" translation in device storage disclosure description in some languages.

1.67.1 (March 29, 2022)

Bug fixes:
  • Purpose Categories with custom icons have wrong alignment.
  • Purposes screen margin issue for iOS 15.4.
  • Wrong focus on tvOS Vendor Details screen after back navigation.
  • Some HTML tags not taken into account for Preferences (Purposes) text.

1.67.0 (March 21, 2022)

  • Improve accessibility of User Information screen
  • Add support for setUser method with authentication on Objective-C
Bug fixes:
  • In some configurations, the IAB TCF Consent String was storing publisher restrictions with too many vendors.

1.66.0 (March 7, 2022)

  • Improve accessibility for purposes and partners screens.
Bug fixes:
  • Ignore invalid Vendor IDs from Publisher Restrictions instead of invalidating the complete list.

1.65.0 (February 10, 2022)

  • Minor accessibility improvements on the Vendors screen.
Bug fixes:
  • A few API Events were not being sent on the tvOS SDK.

1.64.0 (January 26, 2022)


1.63.1 (January 2022)

Bug fixes:
  • Long vendor names were being cut off.
  • Vendors were enabled after setting the switch to the neutral position and saving.

1.63.0 (January 2022)

  • Improve accessibility for the notice and purposes screens
Bug fixes:
  • Button state in the purpose details screen was always disabled when purpose required LI only.
  • The status of some switches was not behaving properly on tvOS when the save button was pressed without making changes.
  • Focus was not working properly on tvOS 15 after selecting a vendor or purpose.

1.62.0 (December 2021)

  • Update fallback data for IAB TCF global vendors list.

1.61.0 (November 2021)

  • Implemented onShowPreferences and onHidePreferences events. These events are triggered when the preferences screens are opened and closed respectively.
Bug fixes:
  • custom text was not being used in the Vendors screen.

1.60.3 (November 2021)

Bug fixes:
  • The XCFramework was not including dSYM nor BCSymbolMap files.

1.60.2 (November 2021)

  • Added Legitimate Interest in TCF Consent String by default once the notice has been shown.
  • Added a new initialize method with a DidomiInitializeParameters parameters object. This is the recommended way to initialize the sdk, the previous methods are now deprecated. See the reference for more information.

1.59.0 (October 2021)

  • Handle deny option as a cross in notice.
Bug fixes:
  • Vendors with no consent or LI purposes were still in the UserStatus global disabled list after calling setUserAgreeToAll.

1.58.1 (September 2021)

  • Apply publisher restrictions with "allow" type to non-IAB vendors as well.
  • Vendors with no associated consent or legitimate interest purpose are now always returned in list.

1.58.0 (September 2021)

  • Display non-TCF purposes in disclosures
  • Add salesforce vendor to global configuration
  • Add a parameter to determine if user consent choice was set from Didomi UI or from a call to Didomi.setUserStatus.
Bug fixes:
  • Hide blank device storage disclosure fields
  • Fix an issue for device storage disclosures when no cookie info is available

1.57.1 (August 2021)

  • Change the default focus on CTV notice according to CNIL guidelines.

1.56.2 (August 2021)

Bug fixes:
  • Removed unused Xcode 11 code.

1.56.1 (July 2021)

Bug fixes:
  • French translation for required was wrong.
  • getUserStatus() was not returning the right value.

1.56.0 (July 2021)

  • Added new getUserStatus method.
Bug fixes:
  • Fixed purpose details button theme.
  • Ensure configuration is only loaded from Didomi on CTV SDK.

1.55.1 (June 2021)

Bug fixes:
  • No event was being triggered when the user switched the toggles in the vendor or purpose details views.
  • Added getQueryStringForWebView method.
  • Migrated framework to Swift 5.0.

1.54.1 (June 2021)

Bug fixes:
  • getUserLegitimateInterestStatusForPurpose and getUserLegitimateInterestStatusForVendor: return .enabled when status is not set (align status with Android).
  • Dismiss preferences sub-screens before dismissing preferences screen.

1.54.0 (May 2021)

  • Applied optimizations around the parsing of vendors information that should reduce the initialization time.
Bug fixes:
  • Hide notice event was not being triggered when user gave/denied consent from the notice.

1.53.1 (May 2021)

Bug fixes:
  • Manage languages with specific script code from device
  • Handle vendor with no consent or LI in getUserStatusForVendor

1.53.0 (May 2021)


1.52.1 (May 2021)

  • Improved header's layout and made bulk action sticky on the Vendors view.
  • Handle setUserStatus with detailed purposes and vendors ids
  • Send dedicated CTV source type to the privacy center on sync request
Bug fixes:
  • Fix setUserConsentStatus result

1.51.0 (May 2021)

Bug fixes:
  • Legitimate interest purposes were not staying as enabled when the user taps on Disagree to all in the Preferences view on tvOS.
  • SDK was getting into a weird state when the IAB Config file was being removed by the OS.
  • Vendors Bulk Action didn't have the right state if there is vendors without consent

1.50.1 (May 2021)

  • Added support for app.deploymentId.
Bug Fixes:
  • Preferences screen title was ignoring text from preferences property.
  • SDK was getting into a weird state when cache directory was being removed by the OS.

1.49.3 (April 2021)

This version requires Xcode 12.
  • Added support for tvOS.

1.48.2 (April 2021)

Please note that this release replaces the IDFA provided by AdSupport for a random custom identifier.
  • Allow users to see and copy their information (Consent Token, User Id and SDK version)
  • Remove usage of IDFA.
  • Added support for Denied Consent Duration (app.deniedConsentDuration)
Bug fixes:
  • The Learn more button was in the wrong position in the notice view.
  • Some HTML tags were being ignored in the notice view.

1.47.0 (March 2021)

  • Added support for purpose categories.
  • Added support to sync user choices across devices.
  • Added a global toggle in the purposes screen that allows to toggle all purposes at once.
Bug fixes:
  • getUserConsentStatusForVendorAndRequiredPurposes was returning false when a vendor had only essential/required purposes.

1.46.0 (March 2021)

  • Updated the behaviour of the Disagree to all buttons in the preferences screen to align with other platforms.
  • Added support for the denyAppliesToLI feature in notice and preferences screen.

1.45.0 (March 2021)

  • Added support for specifying consent expiration.
Bug fixes:
  • Size of consent notice was wrong when displayed a second time.
  • There was an error in the API Events' sampling calculation.

1.44.0 (February 2021)

  • Added support to include Publisher Country Code into Consent String.
Bug fixes:
  • UI event were being triggered before consent was saved.

1.43.0 (February 2021)

  • If you were passing the consent and legitimateInterest parameters to the setUserDisagreeToAll method in your Swift code, it won't compile anymore. If you want to set the consent and legitimate interest status for all vendors and purposes you should use the setUserStatus method instead
  • If you were directly calling setUserDisagreeToAll from Objective-C (setUserDisagreeToAllWithConsent:legitimateInterest:) you would need to use setUserDisagreeToAll instead which does not accept parameters. If you want to set the consent and legitimate interest status for all vendors and purposes you should use the setUserStatus method instead
  • This release also makes private some views and view controllers classes. Currently this SDK is not designed to access these classes directly but only through the available methods which are documented in the references section
  • Added ability to display "Disagree & Close" button on the notice (notice.type = "optin").
  • Added ability to display "Disagree & Close" button as primary (notice.denyAsPrimary = true).
  • Added ability to display "Continue without agreeing" link on the notice (notice.denyAsLink = true).
  • Added some UI updates on the notices.
  • Added new method to set user status for all purposes and vendors setUserStatus(purposesConsentStatus: Bool, purposesLIStatus: Bool, vendorsConsentStatus: Bool, vendorsLIStatus: Bool)

1.42.0 (January 2021)

  • Indicate platform and SDK version when downloading notice configuration.
  • Added support for TCF v2.1.
  • Send TCF and Additional Consent information in API events.

1.41.1 (December 2020)

Bug fixes:
  • In some cases consent was not being properly kept after an update of the GVL.
  • A translation in Croatian was not being displayed properly.

1.41.0 (December 2020)

  • Added Device storage section in the vendor details view.
  • Updated some texts from vendors and purposes.
Bug fixes:
  • Custom initializer hexString:alpha: was being publicly exposed through an extension of the UIColor class which was causing conflicts for some clients that had the same implementation.

1.40.1 (December 2020)

Please notice that this release includes the ability to download the GVL (Global Vendor List) file. If you don't want the SDK initialization to wait for this step, set the app.vendors.iab.requireUpdatedGVL to false as explained here
  • Essential/Required purposes section in the detailed view for each vendor.
  • Download the GVL (Global Vendor List).
  • Optimizations around Publisher Restrictions.
  • Long purpose names were being cut-off.

1.39.0 (November 2020)

  • Detailed additional data processing information
  • Added onError method.

1.38.0 (October 2020)

  • GVL update
  • Remove TCFv1 storage keys when TCFv2 is enabled
  • Improved responsiveness when saving consent
Bug fixes:
  • Ensure that the legitimate interest status is correctly passed to Webviews in getJavaScriptForWebView

1.37.0 (October 2020)

  • Support for Publisher Restrictions.

1.36.1 (September 2020)

Bug fixes:
  • Fixed ratio issue with logo on popup notice.

1.36.0 (September 2020)

  • Updated initialization process to stop requesting location when gdprAppliesGlobally is set to true.

1.35.1 (September 2020)

Bug fixes:
  • App logo was not being displayed on the popup notice.
  • Detailed view of essential purposes contained toggles.

1.35.0 (September 2020)

  • When user.ignoreConsentBefore is set and if consent was collected from the user at a date earlier than user.ignoreConsentBefore, show the consent notice to recollect consent (irrespective of the consent status of the user).
  • Improved the UI of the popup notice to force users to see all the content of the view before selecting any action.
Bug fixes:
  • Close button was not very responsive on the purposes view.

1.34.0 (September 2020)

  • Collect and send organization user ID in API events.

1.33.1 (September 2020)

Bug fixes:
  • Vendors button was not responsive when text on popup notice was long enough to require scroll.

1.33.0 (September 2020)

  • Disable TCF if it is disabled from the Console or if config file does not come from Didomi.

1.32.0 (August 2020)

  • Updated IAB vendors list to 52.

1.31.1 (August 2020)

Bug fixes:
  • Save button on purposes list view didn't have the right state when selections of Consent and Legitimate interest were opposite.

1.31.0 (August 2020)

  • Added support for Google as a TCF vendor.

1.30.2 (July 2020)

Bug fixes:
  • getUserConsentStatusForVendorAndRequiredPurposes was not returning the right status for google and other custom vendors.

1.30.1 (July 2020)

  • Added Show our vendors button to the notice which allows users to navigate directly to the Vendors list view.
  • Added Additional Data Processing section on Purposes list and Vendor Details views.

1.29.0 (July 2020)

  • Ensure that consent is recollected when switching TCF version
Bug fixes:
  • Ensure switch state is accurate on the list of vendors

1.28.0 (July 2020)

  • Better support for dark mode in purpose and vendor detailed views
  • IAB TCF label on TCF vendors in the list of vendors
  • Notice configuration by ID

1.27.2 (July 2020)

Bug fixes:
  • Minor fixes regarding TCFv2.
  • Fixed broken custom text on the Vendors view.

1.27.0 (June 2020)

  • showPreferences allows selecting which view should open (purposes or vendors)

1.26.0 (June 2020)

  • IAB TCF v2 initial support

1.21.0 (June 2020)

  • Use os_log for logging on iOS 10+.
  • Allow setting minimum log level via setLogLevel.
  • Changed the way Purpose details are displayed from expanding a cell to displaying a new view.

1.20.1 (May 2020)

Bug fixes:
  • Banner notice was displaying the rounded top border without transparency.

1.18.1 (March 2020)

  • Added support for XCFramework which means there is no need to use a different Pod (or binary) for newer versions of Xcode (since Xcode >= 11). Using this Pod/binary should be enough: Didomi-XCFramework.

1.17.1 (March 2020)

  • Updated Global Vendor List to version 192.
  • Improved the way in which optionals are handled.

1.16.5 (February 2020)

Bug fixes:
  • Calling the setupUI method multiple times could have resulted in crashes.
  • UI constraints were breaking in some cases when views were displayed behind an interstitial ad.
  • Fixed a race condition when triggering API events which could have resulted in crashes.

1.16.4 (January 2020)

Bug fixes:
  • UI improvements around the scroll bar and the scrolling animation on the Purposes screen when items are expanded/collapsed.
  • Added Didomi.notice.hide(); to the JavaScript code that gets returned by method getJavaScriptForWebView. This means that the notice view on the web app that's loaded on the native app will be hidden automatically when injecting the JavaScript code returned by this method.

1.16.0 (January 2020)

  • Added Xcode 11.3 support.

1.15.4 (Dec 2019)

  • Updated getTranslatedText method to get translated text from multiple sources
  • Created new method updateSelectedLanguage method that allows app developers to change the language of the Didomi SDK.
  • Added the ability to pass a language code when calling the initialize method. This language code will be used to set the selected language.
Existing apps using this implementation of the initialize method in Objective-C:Didomi *didomi = [Didomi shared]; [didomi initializeWithApiKey:@"<Your API key>" localConfigurationPath:nil remoteConfigurationURL:nil providerId:nil disableDidomiRemoteConfig:NO];
will have to add the languageCode parameter and set it to nil unless they want to set a language code: Didomi *didomi = [Didomi shared]; [didomi initializeWithApiKey:@"<Your API key>" localConfigurationPath:nil remoteConfigurationURL:nil providerId:nil disableDidomiRemoteConfig:NO languageCode:nil];
  • The save button in the purposes view was not being enabled property in some cases when the user had previously saved their preferences using an old list of purposes.

1.14.1 (Nov 2019)

  • Added support for Xcode 11.2.
  • Updated the way API events are sampled to be based on user ID rather than on a random number.

1.13.0 (Oct 2019)

  • Introduced ui.action type for events sent to the API for tracking the interactions of the user with the consent UI. Actions added: preferences.shownpurposes, preferences.shownvendors, preferences.purposechanged and preferences.vendorchanged.
Bug fixes:
  • The IABConsent_SubjectToGDPR key was not being set properly in the user defaults.

1.12.2 (Oct 2019)

Bug fixes:
  • UI issue with the purpose switches keeping a stale state when the user toggled the switch and expanded the purpose description right after.

1.12.1 (Sep 2019)

  • Added support for Xcode 11 and bitcode.
Bug fixes:
  • Build was being created using the Debug configuration.
  • Some views were not displaying correctly on iOS 13 when dark mode was enabled.
  • In some cases getting the device location could cause a long delay.
  • Objective-C projects were not compiling correctly under certain configurations.
  • Objective-C projects were not compiling correctly when running on simulator on Xcode 10.2 and 10.3.

1.10.1 (Sep 2019)

  • Improved internal implementation of the SDK to ease the creation of custom views.

1.9.6 (Jul 2019)

Bug fixes:
  • Some mapping keys related to the getText and getTranslatedText methods were not matching the JSON properties of the preferences and notice properties.

1.9.5 (Jul 2019)

  • Updated IAB vendors list to 155.
  • Added the ability to provide translatable texts through the texts property in the didomi_config.json file that can be used when creating a custom notice.

1.9.4 (Jul 2019)

  • Added the ability to block/disable the Agree to all and Disable to all buttons by providing the preferences.disableButtonsUntilScroll flag and setting it to true.

1.9.3 (Jun 2019)

Bug fixes:
  • Event HideNoticeEvent was not triggered as required in some cases.

1.9.2 (Jun 2019)

Bug fixes:
  • The Console generates custom purpose IDs within [A-Za-z0-9-_] and SDKs only allowed [a-z0-9-_]

1.9.1 (May 2019)

  • Added logs to indicate app developers when methods that require the Didomi SDK to be ready are called before that.

1.8.1 (May 2019)

  • Update IAB vendors list (version 146)

1.8.0 (May 2019)


1.7.0 (Apr 2019)

  • Add the possibility to get the configuration remotely from the Didomi console
If you are coming from a previous version and want to enable the remote Didomi configuration created from the console, please add disableDidomiRemoteConfig: false as a new parameter in your initialize function. See documentation.

1.6.0 (Apr 2019)

  • Added pod Didomi-xcode10.2 which supports Xcode 10.2.
Bug fixes:
  • Exposed missing properties of Purpose and Vendor classes.

1.5.1 (Apr 2019)


1.5.0 (Apr 2019)

  • Exposed the following methods: getRequiredPurposes, getRequiredVendors, getEnabledPurposes, getEnabledPurposeIds, getDisabledPurposes, getDisabledPurposeIds, getEnabledVendors, getEnabledVendorIds, getDisabledVendors, getDisabledVendorIds, getPurpose and getVendor.
  • Add Russian and Ukrainian languages

1.4.5 (Mar 2019)

Bug fixes:
  • Preferences popup was being displayed on each visit when notice.enable was set to false and preferences.showWhenConsentIsMissing to true.

1.4.3 (Feb 2019)

  • Updated master config file adding countries, translations, purposes and partners.
  • Exposing shouldConsentBeCollected method used to allow developers to check if consent should be collected or not.
Bug fixes:
  • Items on Purposes and Vendors list were not expanding when clicking right on the expand arrow.
  • SDK had to wait for the country code to get initialised which in some cases could result in the app having to wait for it before starting.
  • Fix translation for "View privacy policy" on the Vendors view

1.4.1 (Feb 2019)

Bug fixes:
  • Purposes description was not being displayed on iPad running iOS 9.3.
  • Fixed strong reference cycles.

1.4.0 (Jan 2019)

Breaking change
This release modifies how we treat the ID of your custom vendors. If you are getting the user consent status with an API function like getUserConsentStatusForVendorAndRequiredPurposes("vendor-id"), you need to update your code to prefix the vendor ID with c:. Your function call now becomes: getUserConsentStatusForVendorAndRequiredPurposes("c:vendor-id").
This change will also trigger consent re-collection for your users.
Bug fixes:
  • The "Disagree to all" button did not use the same text and background color as the "Agree to all" button.
  • Inline style of HTML content was being overridden on the Preferences pop-in.
  • The "Save" button was present but disabled even though all purposes were set to unknown.
  • Purposes were not being properly updated when categories were being used.
  • The "c:" prefix was missing from custom vendors IDs. Important: this could be a breaking change since on the previous version the "c:" prefix was not required before each custom vendor ID.
  • Purposes were not sorted properly on the vendors and purposes views.

1.3.2 (Jan 2019)


  • Supports the 24 European languages
  • Number of days before recollecting consent option in the configuration tag
  • Updates on helpers to ease testability

1.3.1 (Dec 2018)

  • Added the ability to load a remote configuration file so app developers can customize how the SDK is displayed to users
Bug fixes:
  • Fixed potential issue around macros and the way they get replaced in the content

1.2.1 (Dec 2018)

Bug fixes:
  • Fixed logic around showPreferences and forceShowNotice methods so app does not crash after consent has been given
  • Fixed the way notices display long content by enabling scroll when required
  • Correctly load purposes and vendors statuses in the Preferences popup after consent has been given
  • Show the Save button when the Preferences popup is open after consent has been given

1.2.0 (Nov 2018)

  • Custom purposes
  • Map custom vendor to IAB ID
  • Expose getUserConsentStatusForPurpose and getUserConsentStatusForVendorAndRequiredPurposes in the public API
  • Ability to customize texts in the preferences popup

1.1.3 (Nov 2018)

Bug fixes:
  • Minor UI fixes.
  • Updated default notice text.

1.1.2 (Nov 2018)

Bug fixes:
  • Minor UI fixes.

1.1.1 (Nov 2018)

Bug fixes:
  • Exposed additional methods.

1.1.0 (Nov 2018)

  • Added support for Xcode 9
  • Added support for Objective-C