> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/integration/implementation-steps/apple-ios/ios-sdk-changelog.md).

# iOS SDK Changelog

{% updates format="full" %}
{% update date="2026-06-23" %}

## 1.6.4

#### Adds

* More comprehensive on-device debug logging for app messages.
* Improved reliability for recording app message impressions.
  {% endupdate %}

{% update date="2026-05-19" %}

## 1.6.3

#### Fixes

* Fixed an issue that caused the Prompt Debug modal to show randomly.
  {% endupdate %}

{% update date="2026-05-11" %}

## 1.6.2

#### Adds

* Immediate state for ecomm events

#### Fixes

* Granted state for ReAuth flow (picks up authorization state if app was previously granted notification permissions)

#### Updates

* Logs from NSLog to OSLog
  {% endupdate %}

{% update date="2026-04-14" %}

## 1.6.1

* Fixed: Resolved a race condition crash when method swizzling is enabled alongside another library that intercepts the same notification callbacks.
  {% endupdate %}

{% update date="2026-03-12" %}

## 1.6.0

* Adds support for Catalog `RATE_ITEM` and `COMPLETE_ITEM` actions. See the [Catalog Documentation](/integration/implementation-steps/apple-ios/sdk-swift-obj-c/e-commerce-support.md) for more information.
  {% endupdate %}

{% update date="2026-02-17" %}

## 1.5.2

* Fixed: Sorting issue with multiple immediate app messages.
  {% endupdate %}

{% update date="2026-01-08" %}

## 1.5.1

* Cold boot start notification handling for hybrid SDKs.
  {% endupdate %}

{% update date="2025-11-05" %}

## 1.5.0

* Adds support for Catalog `VIEW_ITEM` and `SAVE_ITEM` actions.
  {% endupdate %}

{% update date="2025-10-14" %}

## 1.4.0

#### Added

* Added support for the **immediate** display condition to [App Messages](/platform/app-messages.md).

#### Fixed

* Fixed an issue with App Message global frequency cap calculations.
  {% endupdate %}

{% update date="2025-01-21" %}

## 1.3.9

#### Added

* Added support for push-to-start token registration and observation to [Live Activities](/integration/implementation-steps/apple-ios/sdk-swift-obj-c/live-activities.md).

#### Updated

* Updates `PNNotification.meta` structure to allow more developer friendly value access patterns.

#### **Live Activities - New Methods**

* `PushSDK.LiveActivities.register(_ activityType:, activityHandler:)`
  * Starts observing the provided `activityType` for push-to-start token updates and automatically handles registration. For each activity within the provided `activityType` started via push, or already running, the `activityHandler` is invoked.
* `PushSDK.LiveActivities.register(_ activity:, withId:)`
  * Starts observing the provided `activity` for push token updates and automatically handles registration for the provided activity ID.
    {% endupdate %}

{% update date="2024-12-11" %}

## 1.3.8

#### Added

* Added support for `PNNotification.meta` fields.
  {% endupdate %}

{% update date="2024-07-17" %}

## 1.3.7

#### Added

* Added support for App Message animations.

#### Updated

* Updated internal optimizations on tracked events.
  {% endupdate %}

{% update date="2024-04-23" %}

## 1.3.6

#### Added

* Added session heartbeat support.
* Added application version tracking.

#### Updated

* Updated internal event meta structure.
* Updated PushNotification pause and resume event tracking priority.

#### Fixed

* Fixed an issue with order of cached event hydration.
  {% endupdate %}

{% update date="2024-03-25" %}

## 1.3.5

#### Fixed

* Fixed an issue that could cause background notification registrations to send subscription events.
  {% endupdate %}

{% update date="2024-03-18" %}

## 1.3.4

#### Updated

* Updated event tracking deduplication processes.

#### Fixed

* Fixed an issue that could cause app crash when the number of pending events was too large.
  {% endupdate %}

{% update date="2024-03-12" %}

## 1.3.3

#### Added

* Added privacy manifest.
  {% endupdate %}

{% update date="2024-03-12" %}

## 1.3.2

#### Updated

* Updated App Message serialization for React Native and Flutter consumers.
  {% endupdate %}

{% update date="2024-03-06" %}

## 1.3.1

#### Added

* Added more extensive internal logging.

#### Fixed

* Removed dependencies on `NWPathMonitor`.
  {% endupdate %}

{% update date="2024-03-06" %}

## 1.3.0

#### Added

* Added support for App Messages.
  {% endupdate %}

{% update date="2024-03-07" %}

## 1.2.2

#### Added

* Added more extensive internal logging.

#### Fixed

* Removed dependencies on `NWPathMonitor`.
  {% endupdate %}

{% update date="2024-02-16" %}

## 1.2.1

#### Added

* Added support for pausing and resuming subscriber push notifications.

#### New Properties and Methods

* `PushSDK.PushNotifications.isPaused` - A boolean property indicating the subscriber's notifications are currently paused or not.
* `PushSDK.PushNotifications.pause()` - Will pause a subscriber's ability to receive notifications.
* `PushSDK.PushNotifications.resume()` - Will resume a subscriber's ability to receive notifications.

#### Moved / Deprecated Properties and Methods

* `PushSDK.UserProfile.isSubscribed` has been moved to `PushSDK.PushNotifications.isSubscribed` and will now display a deprecation warning.
* `PushSDK.UserProfile.isEligibleToPrompt` has been moved to `PushSDK.PushNotifications.isEligibleToPrompt` and will now display a deprecation warning.
* `PushSDK.showNativeNotificationPermissionPrompt()` has been aliased to `PushSDK.PushNotifications.showPermissionPrompt()`.
* `PushSDK.UserProfile.revertUserDeletion` will now warn and will be removed in a future release.
  {% endupdate %}

{% update date="2024-01-24" %}

## 1.2.0

#### Added

* Added support for LiveActivities.

#### Live Activities - New Module

* `PushSDK.LiveActivities.track(token:, forActivity:)`
  * Registers the provided pushToUpdate token on the current user to allow updates to the provided activity ID via push.
    {% endupdate %}

{% update date="2023-10-19" %}

## 1.1.5

#### Updated

* Updated internal event tracking metadata.
  {% endupdate %}

{% update date="2023-10-18" %}

## 1.1.4

#### Added

* Added support for [managed integrations](/integration/implementation-steps/apple-ios/advanced/self-managed-integration.md).
  {% endupdate %}

{% update date="2023-08-29" %}

## 1.1.3

#### Updated

* Updated internal resource caching policies.
  {% endupdate %}

{% update date="2023-07-26" %}

## 1.1.2

#### Added

* Added a convenience service for copying the PushSDK Anonymous ID based on specific user interaction.
  {% endupdate %}

{% update date="2023-07-18" %}

## 1.1.1

#### Updated

* Updated error reporting details and internal resource caching.
* Updated debug logging capabilities.
  {% endupdate %}

{% update date="2023-08-29" %}

## 1.0.15

#### Updated

* Updated internal resource caching policies.
  {% endupdate %}

{% update date="2023-07-26" %}

## 1.0.14

#### Added

* Added a convenience service for copying the PushSDK Anonymous ID based on specific user interaction.
  {% endupdate %}

{% update date="2023-07-26" %}

## 1.0.13

#### Updated

* Updated error reporting and internal resource caching.
  {% endupdate %}

{% update date="2023-06-06" %}

## 1.1.0

#### Updated

* Updated error reporting details.

#### Breaking Changes

* Removed automatic badge clearing behavior on app open or resume.
* Updated swizzled methods to call through to the original implementation if present.
  {% endupdate %}
  {% endupdates %}

### Closed Beta Releases

{% updates format="full" %}
{% update date="2023-05-24" %}

## 1.0.12

#### Updated

* Updated the stream ordering of tracked events related to user profiles.
  {% endupdate %}

{% update date="2023-05-17" %}

## 1.0.11

#### Updated

* Updated how `PushSDK.UserProfile.isSubscribed` is reported.
* Updated simulator functionality.
  {% endupdate %}

{% update date="2023-04-20" %}

## 1.0.10

#### Fixed

* Fixed an issue with `PushSDK.UserProfile.remove()` event tracking.
  {% endupdate %}

{% update date="2023-04-12" %}

## 1.0.9

#### Updated

* Updated internal version tracking.
  {% endupdate %}

{% update date="2023-03-16" %}

## 1.0.8

#### Updated

* Updated how resubscribes are tracked and includes simulator builds.
  {% endupdate %}

{% update date="2023-03-13" %}

## 1.0.7

#### Fixed

* Fixed Xcode warnings regarding `linking against a dylib which is not safe for use in application extensions`.
  {% endupdate %}
  {% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/integration/implementation-steps/apple-ios/ios-sdk-changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.