---
source_url: https://www.pubnub.com/docs/sdks/dart/changelog
title: Changelog for Dart SDK
updated_at: 2026-06-19T11:37:16.729Z
sdk_name: PubNub Dart SDK
sdk_version: 7.1.0
---
> Documentation Index
> For a curated overview of PubNub documentation, see: https://www.pubnub.com/docs/llms.txt
> For the full list of all documentation pages, see: https://www.pubnub.com/docs/llms-full.txt
# Changelog for Dart SDK
PubNub Dart SDK, use the latest version: 7.1.0
Install:
```bash
dart pub add pubnub@7.1.0
```
:::note
## v7.1.0
*February 25, 2026*
| Type | Changes |
|------|----------|
| **Added** | • Migration from dart html package to web for wasm compatibility. |
## v7.0.1
*November 17, 2025*
| Type | Changes |
|------|----------|
| **Modified** | • Remove invalid switch cases for null message type which was causing issue with web assembly build. |
## v7.0.0
*October 28, 2025*
| Type | Changes |
|------|----------|
| **Added** | • BREAKING CHANGES: The `hereNow` method will return a maximum of 1000 occupants per channel. Previously, it was returning all occupants without limit parameter support. Use pagination through offset when more than 1000 occupants present in channel. |
| **Fixed** | • Fixes issue of not getting proper error details when file upload fails.
• Fixes issue of no-op when `subscribe()` called on inactive or errored subscrption.
• Fixes issue of generate upload file url to incorporate token when configured or set explicitly.
• Discard use of gcm and replaced with fcm for push notification service type of google. |
| **Modified** | • Pubnub access manager tests. |
## v6.0.2
*October 20, 2025*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of delete message with `from` and `to` parameters. To delete range of message(s). |
## v6.0.1
*August 19, 2025*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes package compatibility issues with web builds. |
| **Modified** | • Allow global custom logger to be ILogger based.
• Upgrade outdated dependencies. |
## v6.0.0
*August 6, 2025*
| Type | Changes |
|------|----------|
| **Added** | • Added support for `RetryPolicy.none()` to disable retry for subscription.
• BREAKING CHANGES: The default retry policy has been changed from applying to all operations to now applying only to the subscription feature. |
| **Modified** | • Enhanced logging using standardized logging practices. |
## v5.2.1
*June 25, 2025*
| Type | Changes |
|------|----------|
| **Fixed** | • Update and validation for `custom` field data type of app context apis to prevent accepting non scalar value.
• Added validation for channel and file names to prevent potential various path traversal techniques. |
## v5.2.0
*March 12, 2025*
| Type | Changes |
|------|----------|
| **Added** | • Added Support of `eTag` for AppContext `setUUIDMetadata` and `setChannelMetadata` APIs. |
## v5.1.1
*January 20, 2025*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of getting error for setUUIDMetadata call without `custom` field. |
## v5.1.0
*December 18, 2024*
| Type | Changes |
|------|----------|
| **Added** | • Added support for `status` and `type` fields in AppContext APIs. |
## v5.0.0
*December 10, 2024*
| Type | Changes |
|------|----------|
| **Added** | • BREAKING CHANGES: Default retry policy for subscription is set to Exponential.
• support for customMessageType in subscription, history, publish, signal and files features. |
| **Fixed** | • Limiting delay to maximum allowable value for Linear retry policy. |
## v4.3.4
*April 15, 2024*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of parsing invalid presence data (which are not from pubnub server) in subscription. |
## v4.3.3
*March 28, 2024*
| Type | Changes |
|------|----------|
| **Added** | • Added support for pagination params for listChannels API of push notification devices. |
## v4.3.2
*January 22, 2024*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of getting signature mismatch exception while publishing encrypted data. |
## v4.3.1
*November 27, 2023*
| Type | Changes |
|------|----------|
| **Fixed** | • Handle unencrypted message while getting messages with cryptoModule configured. |
## v4.3.0
*October 16, 2023*
| Type | Changes |
|------|----------|
| **Added** | • Add crypto module that allows configure SDK to encrypt and decrypt messages. |
| **Fixed** | • Improved security of crypto implementation by adding enhanced AES-CBC cryptor. |
## v4.2.4
*July 27, 2023*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of missing decrypt function in batch history api. |
## v4.2.3
*May 18, 2023*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of losing timetoken value precision in web environment. |
## v4.2.2
*November 14, 2022*
| Type | Changes |
|------|----------|
| **Added** | • Support for Flutter 3. |
| **Fixed** | • Fixes issue of having old version of xml package dependency. |
## v4.2.1
*July 12, 2022*
| Type | Changes |
|------|----------|
| **Added** | • Support for fire in publish feature.
• Allow to specify access rights for user and space in grantToken request.
• Allow users to specify userId instead of uuid. |
## v4.2.0
*May 30, 2022*
| Type | Changes |
|------|----------|
| **Added** | • Adds two presence methods, setState and getState. |
## v4.1.3
*April 21, 2022*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of `fetchMessages` with false includeUUID response parse error.
• Fixes issue of publish file message not triggered on browser. |
## v4.1.2
*April 6, 2022*
| Type | Changes |
|------|----------|
| **Fixed** | • Adds a fix that prevents the SDK from adding forbidden headers in browser environments.
• Fixes getFileUrl method by adding uuid in query parameters. |
## v4.1.1
*April 4, 2022*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes an issue in JS build of Dart SDK, where request bodies were improperly encoded and sent without a correct header. |
## v4.1.0
*December 16, 2021*
| Type | Changes |
|------|----------|
| **Added** | • Added support for Revoke Token feature. |
## v4.0.0
*November 22, 2021*
| Type | Changes |
|------|----------|
| **Added** | • Adds PAM v3 support with `grantToken` and `setToken`.
• After subscribe loop fails, call restore to restart it. |
| **Fixed** | • Subscribe loop no longer throws on unrecoverable failure, instead waits for restart.
• Adds more diagnostics for network module.
• WhenStarts future no longer throws and is now based on a stream.
• Networking should now release all resources after a failure.
• Fixes issue of Signature mismatch with PAM enabled keysets.
• Fixes issue of message decryption with subscription. |
## v3.1.0
*February 16, 2021*
| Type | Changes |
|------|----------|
| **Added** | • Adds signature generation and Objects v2 for PAM Grant call.
• Refactors networking module to use native dart:io. |
| **Fixed** | • Fixes few typos and a bug with BatchHistory meta param.
• Fixes an issue with default params for HereNow call.
• Fixes an issue with encoding of uri query parameters.
• Fixes message decryption in subscribe loop. |
## v3.0.0
*October 8, 2020*
| Type | Changes |
|------|----------|
| **Modified** | • Subscribe loop is now written using async generator and should be easier to debug.
• Exports now are more comprehensive and clear, documentation clarity has been improved. |
| **Fixed** | • Removes additional query params from AWS calls.
• Fixes a bunch of issues with incorrect arguments passed in.
• Adds additional diagnostics to the networking module. |
## v2.0.1
*September 7, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of upgrade failure. |
## v2.0.0
*August 31, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Refactors networking module to allow additional flexibility.
• Adds supervisor module that allows reconnection, retry and other additional, cross module functionalities.
• Adds meta parameter to publish call and makes publish using GET instead of POST. |
| **Fixed** | • Exposes `batch`, `objects` and other APIs from the PubNub class.
• Fixes a typo in BatchHistory where timetoken was returned null. |
## v1.4.4
*August 19, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add flags in history v3 for including messageType and uuid.
• Add support for fetch history with message actions. |
| **Modified** | • Refactor for error message parsing for files. |
## v1.4.3
*August 5, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of exception from server when publishKey is null with publish call.
• Fixes missing url component in file publish message for sendFile and support for message encryption. |
## v1.4.2
*July 27, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of invalid type argument for fcm push gateway type. |
## v1.4.1
*July 24, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issue of missing exposed MessageType enum. |
## v1.4.0
*July 23, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add file apis to support file feature. |
| **Modified** | • Add support for random initialization vector for messages and file. |
## v1.3.0
*June 25, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add message encryption support. |
## v1.2.0
*June 10, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add simplified Objects API support with UUID and Channel metadata / membership management. |
| **Fixed** | • Fixes missing PushGateway type support of fcm for Push Notification. |
## v1.1.3
*May 11, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes unsubscribeAll so its no longer modifying subscription list during iteration.
• Fixes exports to include presence and channel group results. |
## v1.1.2
*May 6, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fixes issues of missing types for objects and push-notification. |
## v1.1.1
*May 6, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Expose missing types. |
## v1.1.0
*May 5, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Refactors logging to rely on Zones.
• Fixes issues with resubscribing and improves injectLogger. |
## v1.0.5
*May 4, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Fix wrong API Uri in Push Notifications.
• Fix Subscription.unsubscribe to correctly close the messages stream. |
## v1.0.4
*April 27, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add HereNow to PresenceDx, usable as `pubnub.hereNow()`. |
| **Fixed** | • Fix subscribe `withPresence: true` not properly forwarding messages when used with wildcard channels. |
## v1.0.3
*April 22, 2020*
| Type | Changes |
|------|----------|
| **Fixed** | • Change all Symbols to Strings to support Flutter better, fix a typo in SubscribeParams preventing subscribe from working. |
## v1.0.2
*April 18, 2020*
| Type | Changes |
|------|----------|
| **Modified** | • Add backward synchronization to private repository for `pubspec.yaml` and `lib/src/core/core.dart`.
• Prevent tests from breaking when version is bumped. |
## v1.0.1
*April 18, 2020*
| Type | Changes |
|------|----------|
| **Modified** | • Refactor PAM, hide logger instances and clean up tests.
• Add `package:pedantic` config to analysis, fix lint issues. |
| **Fixed** | • Ensure()isEqual now uses correct template.
• Add PAM to library exports.
• Consistently use PubNubversion in tests. |
## v1.0.0
*April 15, 2020*
| Type | Changes |
|------|----------|
| **Added** | • Add ability to fetch current PubNub timetoken.
• Add ability to publish messages and signals to channels and channel groups.
• Add ability to subscribe to channels and channel groups.
• Add ability to manage Objects (Spaces, Users and Memberships).
• Add ability to manage PubNub Access Manager.
• Add ability to manage device registration for Push Notification Service.
• Add ability to add, delete and retrieve message actions.
• Add channel and channel group abstractions to allow using History. |
:::
### v7.1.0
February 25, 2026
| Added | Migration from dart html package to web for wasm compatibility. |
| --- | --- |
### v7.0.1
November 17, 2025
| Modified | Remove invalid switch cases for null message type which was causing issue with web assembly build. |
| --- | --- |
### v7.0.0
October 28, 2025
| Added | BREAKING CHANGES: The hereNow method will return a maximum of 1000 occupants per channel. Previously, it was returning all occupants without limit parameter support. Use pagination through offset when more than 1000 occupants present in channel. |
| --- | --- |
| Fixed | Fixes issue of not getting proper error details when file upload fails., Fixes issue of no-op when subscribe() called on inactive or errored subscrption., Fixes issue of generate upload file url to incorporate token when configured or set explicitly., Discard use of gcm and replaced with fcm for push notification service type of google. |
| Modified | Pubnub access manager tests. |
### v6.0.2
October 20, 2025
| Fixed | Fixes issue of delete message with from and to parameters. To delete range of message(s). |
| --- | --- |
### v6.0.1
August 19, 2025
| Fixed | Fixes package compatibility issues with web builds. |
| --- | --- |
| Modified | Allow global custom logger to be ILogger based., Upgrade outdated dependencies. |
### v6.0.0
August 6, 2025
| Added | Added support for RetryPolicy.none() to disable retry for subscription., BREAKING CHANGES: The default retry policy has been changed from applying to all operations to now applying only to the subscription feature. |
| --- | --- |
| Modified | Enhanced logging using standardized logging practices. |
### v5.2.1
June 25, 2025
| Fixed | Update and validation for custom field data type of app context apis to prevent accepting non scalar value., Added validation for channel and file names to prevent potential various path traversal techniques. |
| --- | --- |
### v5.2.0
March 12, 2025
| Added | Added Support of eTag for AppContext setUUIDMetadata and setChannelMetadata APIs. |
| --- | --- |
### v5.1.1
January 20, 2025
| Fixed | Fixes issue of getting error for setUUIDMetadata call without custom field. |
| --- | --- |
### v5.1.0
December 18, 2024
| Added | Added support for status and type fields in AppContext APIs. |
| --- | --- |
### v5.0.0
December 10, 2024
| Added | BREAKING CHANGES: Default retry policy for subscription is set to Exponential., support for customMessageType in subscription, history, publish, signal and files features. |
| --- | --- |
| Fixed | Limiting delay to maximum allowable value for Linear retry policy. |
### v4.3.4
April 15, 2024
| Fixed | Fixes issue of parsing invalid presence data (which are not from pubnub server) in subscription. |
| --- | --- |
### v4.3.3
March 28, 2024
| Added | Added support for pagination params for listChannels API of push notification devices. |
| --- | --- |
### v4.3.2
January 22, 2024
| Fixed | Fixes issue of getting signature mismatch exception while publishing encrypted data. |
| --- | --- |
### v4.3.1
November 27, 2023
| Fixed | Handle unencrypted message while getting messages with cryptoModule configured. |
| --- | --- |
### v4.3.0
October 16, 2023
| Added | Add crypto module that allows configure SDK to encrypt and decrypt messages. |
| --- | --- |
| Fixed | Improved security of crypto implementation by adding enhanced AES-CBC cryptor. |
### v4.2.4
July 27, 2023
| Fixed | Fixes issue of missing decrypt function in batch history api. |
| --- | --- |
### v4.2.3
May 18, 2023
| Fixed | Fixes issue of losing timetoken value precision in web environment. |
| --- | --- |
### v4.2.2
November 14, 2022
| Added | Support for Flutter 3. |
| --- | --- |
| Fixed | Fixes issue of having old version of xml package dependency. |
### v4.2.1
July 12, 2022
| Added | Support for fire in publish feature., Allow to specify access rights for user and space in grantToken request., Allow users to specify userId instead of uuid. |
| --- | --- |
### v4.2.0
May 30, 2022
| Added | Adds two presence methods, setState and getState. |
| --- | --- |
### v4.1.3
April 21, 2022
| Fixed | Fixes issue of fetchMessages with false includeUUID response parse error., Fixes issue of publish file message not triggered on browser. |
| --- | --- |
### v4.1.2
April 6, 2022
| Fixed | Adds a fix that prevents the SDK from adding forbidden headers in browser environments., Fixes getFileUrl method by adding uuid in query parameters. |
| --- | --- |
### v4.1.1
April 4, 2022
| Fixed | Fixes an issue in JS build of Dart SDK, where request bodies were improperly encoded and sent without a correct header. |
| --- | --- |
### v4.1.0
December 16, 2021
| Added | Added support for Revoke Token feature. |
| --- | --- |
### v4.0.0
November 22, 2021
| Added | Adds PAM v3 support with grantToken and setToken., After subscribe loop fails, call restore to restart it. |
| --- | --- |
| Fixed | Subscribe loop no longer throws on unrecoverable failure, instead waits for restart., Adds more diagnostics for network module., WhenStarts future no longer throws and is now based on a stream., Networking should now release all resources after a failure., Fixes issue of Signature mismatch with PAM enabled keysets., Fixes issue of message decryption with subscription. |
### v3.1.0
February 16, 2021
| Added | Adds signature generation and Objects v2 for PAM Grant call., Refactors networking module to use native dart:io. |
| --- | --- |
| Fixed | Fixes few typos and a bug with BatchHistory meta param., Fixes an issue with default params for HereNow call., Fixes an issue with encoding of uri query parameters., Fixes message decryption in subscribe loop. |
### v3.0.0
October 8, 2020
| Modified | Subscribe loop is now written using async generator and should be easier to debug., Exports now are more comprehensive and clear, documentation clarity has been improved. |
| --- | --- |
| Fixed | Removes additional query params from AWS calls., Fixes a bunch of issues with incorrect arguments passed in., Adds additional diagnostics to the networking module. |
### v2.0.1
September 7, 2020
| Fixed | Fixes issue of upgrade failure. |
| --- | --- |
### v2.0.0
August 31, 2020
| Added | Refactors networking module to allow additional flexibility., Adds supervisor module that allows reconnection, retry and other additional, cross module functionalities., Adds meta parameter to publish call and makes publish using GET instead of POST. |
| --- | --- |
| Fixed | Exposes batch, objects and other APIs from the PubNub class., Fixes a typo in BatchHistory where timetoken was returned null. |
### v1.4.4
August 19, 2020
| Added | Add flags in history v3 for including messageType and uuid., Add support for fetch history with message actions. |
| --- | --- |
| Modified | Refactor for error message parsing for files. |
### v1.4.3
August 5, 2020
| Fixed | Fixes issue of exception from server when publishKey is null with publish call., Fixes missing url component in file publish message for sendFile and support for message encryption. |
| --- | --- |
### v1.4.2
July 27, 2020
| Fixed | Fixes issue of invalid type argument for fcm push gateway type. |
| --- | --- |
### v1.4.1
July 24, 2020
| Fixed | Fixes issue of missing exposed MessageType enum. |
| --- | --- |
### v1.4.0
July 23, 2020
| Added | Add file apis to support file feature. |
| --- | --- |
| Modified | Add support for random initialization vector for messages and file. |
### v1.3.0
June 25, 2020
| Added | Add message encryption support. |
| --- | --- |
### v1.2.0
June 10, 2020
| Added | Add simplified Objects API support with UUID and Channel metadata / membership management. |
| --- | --- |
| Fixed | Fixes missing PushGateway type support of fcm for Push Notification. |
### v1.1.3
May 11, 2020
| Fixed | Fixes unsubscribeAll so its no longer modifying subscription list during iteration., Fixes exports to include presence and channel group results. |
| --- | --- |
### v1.1.2
May 6, 2020
| Fixed | Fixes issues of missing types for objects and push-notification. |
| --- | --- |
### v1.1.1
May 6, 2020
| Fixed | Expose missing types. |
| --- | --- |
### v1.1.0
May 5, 2020
| Fixed | Refactors logging to rely on Zones., Fixes issues with resubscribing and improves injectLogger. |
| --- | --- |
### v1.0.5
May 4, 2020
| Fixed | Fix wrong API Uri in Push Notifications., Fix Subscription.unsubscribe to correctly close the messages stream. |
| --- | --- |
### v1.0.4
April 27, 2020
| Added | Add HereNow to PresenceDx, usable as pubnub.hereNow(). |
| --- | --- |
| Fixed | Fix subscribe withPresence: true not properly forwarding messages when used with wildcard channels. |
### v1.0.3
April 22, 2020
| Fixed | Change all Symbols to Strings to support Flutter better, fix a typo in SubscribeParams preventing subscribe from working. |
| --- | --- |
### v1.0.2
April 18, 2020
| Modified | Add backward synchronization to private repository for pubspec.yaml and lib/src/core/core.dart., Prevent tests from breaking when version is bumped. |
| --- | --- |
### v1.0.1
April 18, 2020
| Modified | Refactor PAM, hide logger instances and clean up tests., Add package:pedantic config to analysis, fix lint issues. |
| --- | --- |
| Fixed | Ensure()isEqual now uses correct template., Add PAM to library exports., Consistently use PubNubversion in tests. |
### v1.0.0
April 15, 2020
| Added | Add ability to fetch current PubNub timetoken., Add ability to publish messages and signals to channels and channel groups., Add ability to subscribe to channels and channel groups., Add ability to manage Objects (Spaces, Users and Memberships)., Add ability to manage PubNub Access Manager., Add ability to manage device registration for Push Notification Service., Add ability to add, delete and retrieve message actions., Add channel and channel group abstractions to allow using History. |
| --- | --- |