Version | Release Date | Release Notes |
|---|
2.35.0 | Nov 11, 2026 | Features: Android: The SDK now automatically reports crashes that happen inside the Usercentrics SDK, so we can find and fix problems faster. It needs no setup, has no opt-out, and runs separately from your app's own crash reporting, including your own Sentry. Nothing is reported for users in Europe (EU, EEA, UK and other European countries), when the country is unknown, or when the device is offline. iOS does not report crashes
Fixes:
|
2.34.0 | Oct 29, 2026 | ⚠️ Known Issue: Android release builds with R8 (code shrinking/minification) enabled can fail with Missing classes detected while running R8 for classes in org.jetbrains.annotations. Debug builds and runtime behavior are not affected. This is a problem in release 2.34.0 and is fixed in 2.35.0 — please upgrade to 2.35.0 or later. If you need to stay on 2.34.0, add these rules to your app's R8/ProGuard rules file (for example proguard-rules.pro):
-dontwarn org.jetbrains.annotations.ApiStatus$Experimental
-dontwarn org.jetbrains.annotations.ApiStatus$Internal
-dontwarn org.jetbrains.annotations.VisibleForTesting Features: Added Braze to Consent Mediation, so apps using Braze now follow users' consent choices automatically. On Android the SDK enables or disables Braze for you (apps without Braze are unaffected); on iOS, register a handler with UsercentricsCore.setBrazeConsentHandler to receive the consent decision — the latest decision is delivered as soon as you register
Fixes: Android: Fixed second-layer legal links (e.g. Privacy Policy) navigating twice per tap, which created duplicate back-stack entries Android/iOS: Fixed saveDecisions returning granted non-essential services as denied when called on the first isReady after configure on a fresh install, including when a Controller ID is provided Android/iOS: Fixed a Data Processing Service hidden through the deprecated isHidden template flag showing in its category card but missing from the Services tab. The flag is now ignored, matching Web iOS/tvOS: Fixed a crash when the first or second layer was shown before the SDK was ready or from a background thread. The banner now waits until the SDK is ready, runs on the main thread, and completes with no interaction instead of crashing iOS: Fixed the SDK crashing or failing to initialize offline when the network was slow at startup
|
2.33.2 | Oct 22, 2026 | |
2.33.0 | Oct 14, 2026 | ⚠️ Known Issue: Unity iOS projects using this release may crash, either when the app launches or when the consent banner is shown (if the project uses Swift Package Manager). If you use Unity, please do not use 2.33.0 and upgrade to 2.33.2 instead. This issue only affects Unity on iOS. Features: TCF 2.4: Updated the consent banner (first and second layers, mobile and CTV) with the new mandatory standard text in the Features category, and removed the temporary workaround for the Legitimate Interest special purpose. Feb 23, 2027: Deadline for CMPs to implement the new disclosures in mobile app and CTV environments
Fixes: Android: Fixed the SDK failing to start on first launch when the device is offline, which showed a misleading "wrong configuration" error Android/iOS: Fixed consent choices made while offline not being saved Android/iOS: Fixed the Apps preview ignoring language changes made after the first one, and fixed several other issues in the preview iOS: Fixed a blank gap and overlapping headers on the second layer after expanding a card
|
2.32.0 | Sep 30, 2026 | ⚠️ Known Issue: This release has dependency problems on iOS that can break your app or build. (1) The app can crash at launch on physical devices with a dyld: Symbol not found error referencing Sentry.framework and UsercentricsUI. (2) The Swift Package Manager Package.swift contains an invalid Sentry version (SENTRY_COCOA_2.32.0_PLACEHOLDER), so swift package resolve fails for SPM consumers. Do not use 2.32.0. This issue is fixed in 2.33.0 — please upgrade to 2.33.0 or later. ⚠️ Known Issue (simulators, since 2.31.1): Builds for the iOS and Apple TV (tvOS) simulators that include Intel (x86_64), for example CI or Release builds, fail with no such module 'UsercentricsUI', because the Usercentrics UI package has only included the Apple silicon (arm64) simulator build since 2.31.1. Device builds are not affected, and neither are simulator builds that only target Apple silicon. This applies to all versions since 2.31.1, including 2.33.0 and later, and we are working on a fix. Workaround: build the simulators for Apple silicon (arm64) only, by excluding x86_64 for the simulator in your build settings. Features: PUR — Consent or Pay: Added a "Reject & Subscribe" card to the first-layer banner, a subscriber sign-in link, new onLoginClicked/onSubscribeClicked callbacks, a setting to control whether TCF consent signals are retained on rejection, and a subscription-lapse reset API. Also fixed Deny All on the second layer silently force-consenting users who had no active subscription — it now correctly redirects back to the first layer CTV: Added an "Accept All" button to the second layer and synced TV SDK behavior with the Admin Interface configuration
Fixes: Fixed "Show CMP only to EU and EEA users" having no effect when TCF is enabled, which could resurface the banner to non-EU users Android: Fixed the consent banner overlapping camera cutouts and the side navigation bar on edge-to-edge landscape layouts iOS: Fixed a crash in Consent Mediation with Adjust v5 iOS: Fixed long TCF first layer non-IAB section titles being truncated instead of wrapping Unity: Fixed a deprecated API usage warning with no functional impact
|
2.31.0 | Sep 10, 2026 | Features: Added an optional Controller ID parameter at SDK initialization (Android, iOS, React Native, Flutter, Unity), letting apps preserve a previously issued user identity across login/logout flows that clear local consent storage Android: Consent banner now correctly handles edge-to-edge display and no longer overlaps system bars, also available via React Native and Flutter
Fixes:
|
2.30.0 | Aug 19, 2026 | Features: Added support for Unity Ads Vector's End-User Consent Mode, so apps using Unity Ads mediation now automatically apply users' consent choices to analytics and advertising Android: Consent selections made in the detailed (second layer) consent screen are no longer lost if the screen is recreated, for example after switching between light and dark mode Flutter: Added Swift Package Manager (SPM) support for iOS integrations, recommended for apps using Xcode 15 or later, alongside continued CocoaPods support
Fixes: Android: Fixed a crash affecting apps using Crashlytics consent mediation together with Firebase BOM 34 or newer Android: Fixed a crash during SDK initialization that could occur in Unity Development builds; Production builds were not affected
|
2.29.1 | Aug 5, 2026 | |
2.28.2 | Jul 22, 2026 | iOS Fix: PUR Fix: TCF Fix: Removed Special Purposes from the first layer of the TCF banner — not a first-layer requirement Fixed purposes and special features being disclosed in the second layer (and included in the TC string) even when no vendor declared them, when Stacks are enabled
|
2.28.1 | Jul 15, 2026 | |
2.28.0 | Jul 8, 2026 | Android/iOS Fix: Android Fix: iOS Fix: PUR Fix: Billing Fix: TCF Fix:
|
2.27.3 | Jun 25, 2026 | Android/iOS Fix: iOS Fix: Android:
|
2.27.1 | Jun 15, 2026 | ⚠️ Known Issue: A Swift Package Manager integration issue was identified in this release that could disrupt build pipelines for CocoaPods users. Upgrading to 2.27.3 fully resolves this issue. iOS — Accessibility: Multiple VoiceOver improvements ensuring correct language pronunciation, properly exposed consent content to screen readers, interactive elements announced with their correct roles, focus correctly restored after language changes, and visible focus indicators for all assistive technologies — improving WCAG compliance across the consent UI
iOS Fixes: Fixed a crash when tapping the service info icon in the Second Layer Categories tab Improved stability of the consent banner presentation, preventing unintended duplicate displays
Android/iOS Fix: PUR Fix:
|
2.27.0 | Jun 1, 2026 | Known issues from 2.26.3 fixed. Features: PUR Compliance: Mandatory label for purposes absent from publisher restrictions, and option to hide vendor toggles on the Vendors/DPS tab. Extended to Flutter, React Native, and Unity Unity: Exposed GDPR legal texts in getCmpData and added changeLanguage() API
Android — Accessibility: Multiple TalkBack improvements: correct language pronunciation, visible focus indicators, proper roles for buttons, accordions, and external links, fixed unexpected focus jumps after accordion interactions, and screen reader support for consent history
Android Fixes: iOS Fix: TV Fix:
|
2.26.3 | May 14, 2026 | ⚠️ Known Issue: A Swift Package Manager dependency resolution issue has been identified on Xcode 26+, where usercentrics-spm-ui fails with unknown dependency 'Usercentrics' in target 'UsercentricsUI' and public headers directory path is invalid. Fixed in 2.27.0. ⚠️ Action required for Firebase Consent Mediation users: Due to the Firebase KTX migration bug (fixed in this release), Firebase Analytics consent was silently not being applied for all apps using Firebase BOM 32+ (released June 2023). If your app uses Firebase Consent Mediation, please upgrade to 2.26.3 to restore correct behavior. ⚠️ Flutter iOS users: The consentMediation flag was not being forwarded to the native iOS SDK, causing consent mediation to be silently disabled on iOS for Flutter apps. This is now fixed. The TCF ATP infinite banner resurface issue partially fixed in 2.26.2 is now fully resolved — ghost vendor IDs from Google's ATP registry no longer cause false resurfaces. Consent Mediation Fixes: Fixed FirebaseAnalyticsMediationSDK failing for apps using Firebase 32+ due to the Firebase KTX migration Fixed setAnalyticsCollectionEnabled(true) not being called after consent is granted, causing Firebase Analytics to remain permanently disabled on Android and iOS
Android Bug Fixes: Flutter Fix:
|
2.26.2 | Apr 16, 2026 | Known issues from 2.26.1 fixed. ⚠️ Known Issue: A Swift Package Manager dependency resolution issue has been identified on Swift 6.2 / Xcode 26.3, where usercentrics-spm-ui fails with unknown dependency 'Usercentrics' in target 'UsercentricsUI'. If you experience SPM resolution issues, please run swift package purge-cache to clean your cache. A fix will be available in the upcoming release. Improvements: Android Bug Fixes: Fixed consent banner ignoring "Popup" mode dashboard configuration and always showing fullscreen Fixed shouldCollectConsent always returning true after app relaunch on TCF configs Fixed window leak when activity finishes while consent banner is still showing Fixed ATP list updates that could lead to infinite banner resurfaces
iOS Bug Fixes: Fixed SVG banner logo failing to load due to SVGKit parsing error Fixed missing padding and misalignment between toggle and label in second layer Fixed toggle dropdown arrow alignment Fixed Swift Package Manager unable to resolve usercentrics-spm-ui package
TCF Fixes: Other Fixes:
|
2.26.1 | Apr 07, 2026 | ⚠️ Known Issue: This release contains a bug where shouldCollectConsent may return true after app relaunch, ignoring previously stored consent. This does not occur if a resurfacing period is configured in the Admin UI. Please upgrade to version 2.26.2 which includes a fix for this issue. Features: Added support for US National (GPP) privacy framework Extended GPP API to Flutter, React Native and Unity bridges Exposed DPS metadata via new getDpsMetadata() API TCF resurfacing period now configurable via Admin UI (1–13 months)
Bug Fixes: Fixed TCF resurfacing period logic Fixed stored information not shown on DPS details Fixed TCF maintain legitimate interest logic on Deny All Fixed race conditions across the SDK
|
2.25.1 | Mar 02, 2026 | |
2.25.0 | Feb 23, 2026 | Vendor Disclosure: Added detailed storage information (specialPurposes, optOut, description) and SDKs section within vendor disclosures in the second layer UI. Supported on Android, iOS, Android TV, and tvOS. Bug Fixes: iOS, React Native (RN 0.79+ New Architecture type mismatch), and general UI fixes.
|
2.24.4 | Jan 27, 2026 | Improvement: Added a new feature allowing admins to show or hide the "Manage Settings" button. Improvement: Added TCF Storage Disclosures and detailed storage information views for CTV. Improvement: Updated logic to ensure unsaved Legitimate Interest settings are correctly captured even after a user clicks "Deny All". Improvement: Added status text for Legitimate Interest (LI) toggles on Android TV and AppleTV to clearly show if they are enabled/disabled. Improvement: UI improvements and fixes.
|
2.24.3 | Dec 18, 2025 | Improvement: Added proper labels for Consent and Legitimate Interest toggles in the CTV second layer, resolving TCF policy check 23. Improvement: Introduced vendor storage information section (cookies and non-cookie access details) in the CTV second layer, addressing TCF policy check 24. Note: Changes apply to both Android and iOS CTV implementations.
|
2.24.2 | Dec 12, 2025 | ⚠️ Notice: A checksum issue was identified and fixed. If you experience SPM cache issues, please run swift package purge-cache to clean your SPM cache. iOS dSYM Files: dSYM files are now included for Usercentrics.framework and UsercentricsUI.framework. TCF Legitimate Interest: Added maintain Legitimate Interest feature toggle to preserve legitimate interest for TCF purposes 2, 7, 8, 9, 10, 11 on Deny All scenarios. React Native: Fixed iOS build issues for Expo apps using the new architecture.
|
2.24.1 | Nov 21, 2025 | |
2.24.0 | Nov 3, 2025 | ⚠️ Known Issue: This release has incorrect format of TC String. We recommend using a more recent stable version. TCF 2.3 Support: Support the latest Transparency & Consent Framework 2.3. Special Features Section: Added support for the new Special Features/Purposes section. Android: Fix issue where the SDK failed to initialize offline. React Native Update: Added Fabric renderer compatibility.
|
2.23.3 | Oct 7, 2025 | React Native Update: Upgraded to React Native 0.79.6 to ensure compatibility with 16 KB page sizes. Security Improvements: Addressed minor CVE vulnerabilities for enhanced application safety. ⚠️ Notice: Versions 2.23.1 and 2.23.2 should be avoided due to React Native related issues. Please upgrade directly to 2.23.3.
|
2.23.0 | Sep 15, 2025 | Android/iOS Bug Fixes: Fixed bugs related to Google Consent Strings on DenyAll, ensuring correct consent handling Resolved geolocation issue reported in version 2.22.2 Fixed accessibility contrast issues for improved usability
|
2.22.2 | Aug 7, 2025 | ⚠️ Known Issue: This release contains a bug that triggers an “Error on geolocation change”. We recommend using more recent stable version. |
2.21.1 | Jul 29, 2025 | |
2.21.0 | Jun 17, 2025 | |
2.20.3 | May 30, 2025 | |
2.20.2 | May 27, 2025 | |
2.20.1 | May 7, 2025 | |
2.20.0 | April 16, 2025 | |
2.19.0 | March 24, 2025 | |
2.18.9 | February 27, 2025 | |
2.18.6 | February 05, 2025 | |
2.18.5 | January 23, 2025 | |
2.18.4 | January 07, 2025 | |
2.18.3 | December 11, 2024 | |
2.18.2 | November 27, 2024 | |
2.18.1 | November 20, 2024 | |
2.18.0 | November 14, 2024 | |
2.17.3 | October 17, 2024 | |
2.17.2 | October 1, 2024 | |
2.17.1 | September 25, 2024 | |
2.17.0 | September 18, 2024 | |
2.16.0 | August 29, 2024 | [Feature] New timeout mode - In this version, you are able to customize the global timeout for the maximum amount of time that the SDK should take to fully initialize, just set the new parameter on the UsercentricsOptions.
|
2.15.6 | August 15, 2024 | |
2.15.5 | July 31, 2024 | |
2.15.4 | July 17, 2024 | |
2.15.2 | June 12, 2024 | |
2.15.1 | May 29, 2024 | [Improvement] Consent Mediation - Specific implementation for Firebase Analytics and Advertising SDK [Improvement] Reset method deprecated for the SDK, React Native, Flutter and Unity [Improvement] Added support for new TCF languages [Improvement] Changed TCF resurface period: from 13 months to 390 days [iOS Bug Fix] UI improvement [General Fixes] Some DPSs had the cookie storage wrongly displayed
|
2.15.0 | April 25, 2024 | [Improvement] Upgrade to latest Kotlin version 1.9.23 [Improvement] Officially changed Android SDK minimum version to API 21 [Improvement] Releasing iOS SDKs that supports manual linkage [Improvement] General improvements on Google Consent Mode [Improvement] Apple Privacy Manifest - Added new requirements to support new compliance rules
iOS Bug Fixes: [Fix] Some toggles could appear for vendors without any legal basis being applied [Fix] Crashes on Xcode 15.2 when using new Apple's libraries linkage mechanism [Fix] IronSource Consent Mediation integration tweaks to support their latest release
Other Fixes: [Fix] Links not supported on banner message customizations were being displayed [Fix] Controller ID card were not visible in certain conditions when Google Additional Providers were not present [Fix] GDPR Banner was reappearing after a very specific scenario that changed the rule if it should be resurfaced or not
|
2.14.2 | April 10, 2024 | |
2.14.0 | April 04, 2024 | |
2.13.2 | March 13, 2024 | [Improvement] Google Consent Mode Granular Choices - Enhances integration with Google SDKs by updating to the latest changes. Explore the details here [Improvement] Adjust Granular Consent - By Using Consent Mediation, we have fully integrated with Adjust SDK updates associated with the DMA
iOS Bug Fixes: [Fix] Adjusts in landscape mode where labels were not fully aligned with other elements of the screen [tvOS Fix] Numerous layout modifications have been made to address the arrangement of titles and the rendering of other elements in languages that result in larger text sizes
Other Fixes: [Fix] Removes deprecated field TCFVendor::deviceStorage [Fix] In certain scenarios, the 'Save Settings' button color was not customizable
|
2.13.0 | February 29, 2024 | [Feature] New Usercentrics Ready API - The API's new properties introduce a feature that, through Rulesets, allows identification of scenarios where the banner may be bypassed in specific locations, check it out
[Improvement] Removes TCF 2.0 warnings - Since TCF 2.0 has been deprecated, we've removed all warnings regarding the usage of version 2.0 of this framework [Improvement] New TCF 2.2 Stacks - Added support for Stacks 44 and 45
|
2.12.0 | February 15, 2024 | Other Fixes: [Fix] Aligned purposes descriptions/illustrations and vendor data with GVL translation [Fix] Edge case when certain services, hidden by their respective categories, were visible" [Fix] Minor issues on session restoration when using TCF
|