> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Notes

> iOS SDK updates and announcements

<Update label="v2.5.2" description="May 2026">
  * Defaults to the Core Engine when no A/B test configuration applies **(Fix)**
  * Persists Core Engine state in file storage instead of UserDefaults to fit within the tvOS UserDefaults size limit **(Fix)**
</Update>

<Update label="v2.5.1" description="March 2026">
  * Improves Core Engine state persistence for workspaces with large query sets **(Fix)**
</Update>

<Update label="v2.5.0" description="March 2026">
  * Fixes Core Data memory accumulation with large query sets **(Fix)**
</Update>

<Update label="v2.4.1" description="March 2026">
  * Include contextual cohorts in classification model inputs **(Update)**
</Update>

<Update label="v2.4.0(32)" description="January 2026">
  * Adds native cohort evaluation to replace JavaScript evaluation **(New)**
  * Fixes race condition in third-party data refresh during startup **(Fix)**
  * Fixes duplicate audience matching API calls **(Fix)**
  * Fixes duplicate geoIP calls on SDK startup **(Fix)**
</Update>

<Update label="v2.3.0(31)" description="September 2025">
  * Adds support for contextual cohorts and enrichment using the new contextual data platform **(New)**
  * Adds caching to reduce load when fetching activations for appending to Google Ad Manager ad requests **(Update)**
</Update>

<Update label="v2.2.1(30)" description="February 2025">
  * Resolves a crash in CoreData due to conflicting fetchRequests **(Fix)**
</Update>

<Update label="v2.2.0(29)" description="September 2024">
  * Reduces the number of events being persisted on device by aggregating SegmentEntry and Exit events into PageViewComplete **(Update)**
</Update>

<Update label="v2.1.3(28)" description="May 2024">
  * Add a configuration option to disable low memory mode **(Update)**
  * Drops support for iOS 11. iOS 12 is now the minimum version supported **(Update)**
</Update>

<Update label="v2.1.2(27)" description="May 2024">
  * Update privacy manifest UserDefaults key **(Fix)**
</Update>

<Update label="v2.1.1(26)" description="May 2024">
  * Update privacy manifest to include UserDefaults usage **(Update)**
</Update>

<Update label="v2.1.0(25)" description="April 2024">
  * Add privacy manifest to bundle **(New)**
  * Fixed an issue where the SDK would repeatedly retry some network calls if the connection was blocked **(Fix)**
  * Fixed issue with Classification Model configuration options **(Fix)**
</Update>

<Update label="v2.0.0(24)" description="July 2023">
  * Updated API to retrieve activations **(New)**
  * Updated API to retrieve cohorts, including classification models if supported **(New)**
  * Updated trigger action API to return as String type rather than Int **(Update)**
  * Added support for classification models **(New)** Please reach out to your CSM if you wish to enable this feature
  * Deprecated segments property **(Deprecation)**
  * Deprecated reactions property **(Deprecation)**
</Update>

<Update label="v1.6.0(23)" description="May 2023">
  * API to identify a user with the IDFA tag and UUID **(New)**
</Update>

<Update label="v1.5.2(22)" description="February 2022">
  * Fixed an issue where writing to standard defaults can cause a crash in certain cases **(Fix)**
</Update>

<Update label="v1.5.1(21)" description="December 2022">
  * Updates MediaTracker video event names to drop CTV prefix **(Update)**
</Update>

<Update label="v1.5.0(20)" description="July 2022">
  * Improved developer logging **(New)**
  * Fixed an issue which allowed event tracking before ready **(Fix)**
</Update>

<Update label="v1.4.0(19)" description="May 2022">
  * API to expose current user ID **(New)**
  * API offering setting Alias priority and expiry for use with identity calls **(New)**
</Update>

<Update label="v1.3.0(18)" description="March 2022">
  * Addition allow event enrichment with IBM Watson **(New)**
</Update>

<Update label="v1.2.2(17)" description="February 2022">
  * Addition to integrate use of Third Party Data when activated **(New)**
  * Fixed an issue which could cause Core Data crash **(Fix)**
  * Fixed an issue which used invalid bundle version information **(Fix)**
</Update>

<Update label="v1.2.1(16)" description="December 2021">
  * Performance improvements and bug fixes **(Fix)**
</Update>

<Update label="v1.2.0(15)" description="December 2021">
  * Addition of video tracking support **(New)**
</Update>

<Update label="v1.1.0(14)" description="October 2021">
  * Addition of GAM helper API **(New)**
</Update>

<Update label="v1.0.0(13)" description="October 2021">
  * Production v1 release
  * Improved PageTracker API **(Fix)**
</Update>

<Update label="v1.0.0-beta4(12)" description="July 2021">
  * PageTracker refreshes session expiry **(Fix)**
  * Improved PageTracker concurrency handling **(Fix)**
  * Prevent tracking of events with empty names **(Fix)**
  * Moved identity addition to SDK queue **(Fix)**
  * Aliases published on SDK start **(Update)**
  * Metric tracking duration fix for identity and PageTracker **(Fix)**
  * User settings load after persistence initialisation **(Fix)**
</Update>

<Update label="v1.0.0-beta3(11)" description="April 2021">
  * Addition of State Sync feature **(New)**
  * Addition of Identity feature **(New)**
  * Fix an issue converting Ints to Booleans in EventProperties **(Fix)**
  * Fix Metric schema issue **(Fix)**
  * Make error thrown from Permutive API more informative **(Update)**
  * Fix call stack used with SDK errors **(Fix)**
  * Fix to allow partial connection information use **(Fix)**
  * PageTracker inherits from NSObject to allow strong references **(Fix)**
</Update>

<Update label="v1.0.0-beta2" description="December 2020">
  * Fix an issue with ABI stability affecting some users **(Fix)**
</Update>

<Update label="v1.0.0-beta1" description="December 2020">
  * Added support for PageView Engagement **(New)**
  * Added support for Metric Persistency **(New)**
</Update>

<Update label="v1.0.0-alpha8" description="November 2020">
  * Restoration of all user data from persistence **(Fix)**
</Update>

<Update label="v1.0.0-alpha7" description="November 2020">
  * Addition of canary deployment feature **(New)**
  * Renaming of SDK Error class **(Fix)**
  * High CPU usage bug fix **(Fix)**
  * Addition of SDK reset API **(New)**
  * Removal of persistent data of previous alpha SDK on start **(New)**
  * Event schema errors reported in SDK log **(New)**
  * SDK persists session **(New)**
</Update>

<Update label="v1.0.0-alpha5" description="September 2020">
  * Simplified EdgeProcessor logic **(Update)**
  * Change of Context API **(Update)**
  * Updated PageTracker API naming **(Update)**
</Update>

<Update label="v1.0.0-alpha4" description="September 2020">
  * API Added documentation **(New)**
  * Addition Background awareness **(New)** Allows tracking of activity in background for better performances.
  * Addition CoreData Migration **(New)** Allows upgrading of Data Model without reinstalling the application.
  * Addition of PageView Tracking **(New)** Allows tracking of a PageView and PageViewComplete.
  * Addition of Lookalike model **(New)**
  * Addition of Mac Catalyst support **(New)** Allows support of OS X platform.
</Update>

<Update label="v1.0.0-alpha3" description="June 2020">
  * API typo fix **(Fix)**
</Update>

<Update label="v1.0.0-alpha2" description="June 2020">
  * API to return SDK version **(New)** Allows SDK users to interrogate SDK for version.
  * Addition of tvOS platform **(New)** Allows release of a tvOS compatible SDK.
  * Addition of tvOS integration test target **(New)** Allow running integration tests on tvOS simulator as XCTest target.
  * Addition of tvOS integration app **(New)** Allows running integration tests on tvOS devices.
  * Deactivates SDK on low system memory **(Fix)**
</Update>