NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #334 most downloaded on pub.dev
Flutter plugin for Cloud Firestore, a cloud-hosted, noSQL database with live synchronization and offline support on Android and iOS.
Last release 21 days ago
14 Sep 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
292 releases · first in 2017
FIX(firestore,web): Propagate FirebaseException properly, fix mergeFields bug, fix bytesLoaded different type under different conditions (#12334).
FirebaseException properly, fix mergeFields bug, fix bytesLoaded different type under different conditions (#12334). (fdde75b0)AggregateField type to users (#12305). (2b83defa)not-in & in filters in the same query (#12307). (e538338c)average() is null when collection is empty or collection doesn't exist or the property doesn't exist on docs (#12304). (4d3b578d)One column per quarter.
FIX(firestore,web): fix an issue where nested object could be incorrectly decoded from JSObjects (#12289).
FIX(firestore,web): fix an issue where nested object could be incorrectly decoded from JSObjects (#12272).
Update a dependency to the latest release.
Update a dependency to the latest release.
FEAT(core): bump Firebase iOS SDK to 12.19.0 (#18683).
null cannot be used for isEqualTo or isNotEqualTo in a query. (#12164). (cff6f767)setSettings to allow usage of a up-to-date persistence on web (#12041). (c9174334)REFACTOR(core,android): migrate native implementation to Kotlin (#18570).
transaction.get() should throw FirebaseException on exception. (#12064). (3cfc5019)LoadBundleTaskState in cloud_firestore (#12065). (97903034)sum and average aggregated queries (#11757). (82af6c2f)FIX(firestore): revert changes to isLessThan, isLessThanOrEqualTo,isGreaterThan, isGreaterThanOrEqualTo & arrayContains. null is not valid.. (#12017).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX(firestore): allow null value to isEqualsTo & isNotEqualsTo in where() query (#11896).
FIX(firestore,android): fix a race condition that could cause a crash when adding event channels while closing the app (#11881).
FIX(firestore,core,windows): per-engine BinaryMessenger, Firestore/Auth link order, Profile builds (#18516).
FIX(firestore,android): cacheSizeBytes value cannot be null when setting persistenceEnabled (#11794).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
firebase_auth - v6.5.4firebase_database - v12.4.4firebase_messaging - v16.4.1firebase_ai - v3.13.1firebase_data_connect - v0.3.0+5Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_ai - v3.13.1firebase_data_connect - v0.3.0+5FEAT(appcheck): appcheck reCAPTCHA mobile support (gradually rolling out) (#18261).
FEAT(messaging,android): improve how messaging is determining permission on Android (#18101).
Update a dependency to the latest release.
FIX(firestore): allow DocumentReference to be used to in Filter queries (#11593).
FIX(cloud_firestore): Fix crashes on iOS/macOS (#11501).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.5.0cloud_firestore_web - v5.5.0firebase_auth - v6.5.2firebase_auth_platform_interface - v9.0.2firebase_core - v4.10.0firebase_core_web - v3.8.0firebase_messaging - v16.3.0firebase_messaging_platform_interface - v4.8.0firebase_messaging_web - v4.2.0firebase_ai - v3.12.2firebase_data_connect - v0.3.0+3firebase_auth_web - v6.2.2_flutterfire_internals - v1.3.72cloud_firestore_platform_interface - v8.0.2cloud_functions - v6.3.2cloud_functions_platform_interface - v6.0.2cloud_functions_web - v5.1.8firebase_analytics - v12.4.2firebase_analytics_platform_interface - v6.0.2firebase_analytics_web - v0.6.1+8firebase_app_check - v0.4.4+2firebase_app_check_platform_interface - v0.4.0+2firebase_app_check_web - v0.2.4+3firebase_app_installations - v0.4.2+3firebase_app_installations_platform_interface - v0.1.4+71firebase_app_installations_web - v0.1.7+8firebase_crashlytics - v5.2.3firebase_crashlytics_platform_interface - v3.8.23firebase_database - v12.4.2firebase_database_platform_interface - v0.4.0+2firebase_database_web - v0.2.7+9firebase_in_app_messaging - v0.9.2+3firebase_in_app_messaging_platform_interface - v0.2.5+23firebase_ml_model_downloader - v0.4.2+3firebase_ml_model_downloader_platform_interface - v0.1.5+23firebase_performance - v0.11.4+2firebase_performance_platform_interface - v0.2.0+2firebase_performance_web - v0.1.8+8firebase_remote_config - v6.5.2firebase_remote_config_platform_interface - v3.0.2firebase_remote_config_web - v1.10.9firebase_storage - v13.4.2firebase_storage_platform_interface - v6.0.2firebase_storage_web - v3.11.8Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_ai - v3.12.2firebase_data_connect - v0.3.0+3firebase_auth_web - v6.2.2_flutterfire_internals - v1.3.72cloud_firestore_platform_interface - v8.0.2cloud_functions - v6.3.2cloud_functions_platform_interface - v6.0.2cloud_functions_web - v5.1.8firebase_analytics - v12.4.2firebase_analytics_platform_interface - v6.0.2firebase_analytics_web - v0.6.1+8firebase_app_check - v0.4.4+2firebase_app_check_platform_interface - v0.4.0+2firebase_app_check_web - v0.2.4+3firebase_app_installations - v0.4.2+3firebase_app_installations_platform_interface - v0.1.4+71firebase_app_installations_web - v0.1.7+8firebase_crashlytics - v5.2.3firebase_crashlytics_platform_interface - v3.8.23firebase_database - v12.4.2firebase_database_platform_interface - v0.4.0+2firebase_database_web - v0.2.7+9firebase_in_app_messaging - v0.9.2+3firebase_in_app_messaging_platform_interface - v0.2.5+23firebase_ml_model_downloader - v0.4.2+3firebase_ml_model_downloader_platform_interface - v0.1.5+23firebase_performance - v0.11.4+2firebase_performance_platform_interface - v0.2.0+2firebase_performance_web - v0.1.8+8firebase_remote_config - v6.5.2firebase_remote_config_platform_interface - v3.0.2firebase_remote_config_web - v1.10.9firebase_storage - v13.4.2firebase_storage_platform_interface - v6.0.2firebase_storage_web - v3.11.8FIX(firestore): allow FieldPath.documentId as a field argument in queries (#11443).
FIX(firestore): remove assertion for arrayContainsAny & whereIn query combined (#11342).
FIX(firestore): allow 30 conjunctive & disjunctive queries for "in" & "array-contains-any" via where() API (#11265).
withConverter and returning null from fromFirestore (#11224). (4dd0f3f0)Filter.or() & Filter.and() (#11140). (e1f0064d)FIX(firestore,apple): issue where setting persistence caused a crash. kFIRFirestoreCacheSizeUnlimited no longer usable. (#11174).
FIX(firestore): update deprecated persistence API (#11069).
FEAT(messaging,web): add support for custom service worker script path in getToken method (#18290).
FIX(auth,android): Fix crash on Android where detaching from engine (#11296).
FEAT(core): bump Firebase Android SDK to 34.12.0 (#18185).
FIX(core): bump Firebase C++ SDK to 13.5.0 (CMake deprecation fix) (#18071).
FIX(firestore,ios): clean up event listeners on engine detach only (#10579).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
FIX(firestore): ensure all index URLs are captured and passed to the user (#10674).
FEAT(core,windows): update C++ Desktop SDK to 13.4.0. This may require updating your Visual Studio version and C++ build tools. (#18006).
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: bump firebase_core_platform_interface version to fix previous release.
firebase_core_platform_interface version to fix previous release. (bea70ea5)Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v3.2.0cloud_firestore_odm - v1.0.0-dev.19cloud_firestore_odm_generator - v1.0.0-dev.19cloud_functions - v3.3.0firebase_app_check - v0.0.6+15firebase_app_installations - v0.1.1firebase_auth - v3.4.0firebase_auth_platform_interface - v6.3.0firebase_auth_web - v3.3.18firebase_core - v1.19.0firebase_dynamic_links - v4.3.0firebase_ml_model_downloader - v0.1.1firebase_performance - v0.8.1firebase_storage - v10.3.0flutterfire_ui - v0.4.2+1firebase_in_app_messaging - v0.6.0+17firebase_in_app_messaging_platform_interface - v0.2.1+9firebase_crashlytics - v2.8.3firebase_crashlytics_platform_interface - v3.2.9firebase_remote_config - v2.0.10firebase_remote_config_web - v1.0.15firebase_remote_config_platform_interface - v1.1.9firebase_database_web - v0.2.0+16firebase_database - v9.0.17firebase_database_platform_interface - v0.2.1+9firebase_dynamic_links_platform_interface - v0.2.3+5cloud_firestore_web - v2.6.18cloud_firestore_platform_interface - v5.5.9firebase_app_installations_web - v0.1.0+16firebase_app_installations_platform_interface - v0.1.1+9firebase_messaging_web - v2.4.3firebase_messaging - v11.4.3firebase_messaging_platform_interface - v3.5.3firebase_analytics_platform_interface - v3.1.9firebase_analytics - v9.1.11firebase_analytics_web - v0.4.0+16firebase_ml_model_downloader_platform_interface - v0.1.1+9firebase_app_check_platform_interface - v0.0.4+9firebase_app_check_web - v0.0.5+15cloud_functions_web - v4.2.17cloud_functions_platform_interface - v5.1.9firebase_storage_web - v3.2.18firebase_storage_platform_interface - v4.1.9firebase_performance_platform_interface - v0.1.1+9firebase_performance_web - v0.1.0+15Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_in_app_messaging - v0.6.0+17firebase_in_app_messaging_platform_interface - v0.2.1+9firebase_crashlytics - v2.8.3firebase_crashlytics_platform_interface - v3.2.9firebase_remote_config - v2.0.10firebase_remote_config_web - v1.0.15firebase_remote_config_platform_interface - v1.1.9firebase_database_web - v0.2.0+16firebase_database - v9.0.17firebase_database_platform_interface - v0.2.1+9firebase_dynamic_links_platform_interface - v0.2.3+5cloud_firestore_web - v2.6.18cloud_firestore_platform_interface - v5.5.9firebase_app_installations_web - v0.1.0+16firebase_app_installations_platform_interface - v0.1.1+9firebase_messaging_web - v2.4.3firebase_messaging - v11.4.3firebase_messaging_platform_interface - v3.5.3firebase_analytics_platform_interface - v3.1.9firebase_analytics - v9.1.11firebase_analytics_web - v0.4.0+16firebase_ml_model_downloader_platform_interface - v0.1.1+9firebase_app_check_platform_interface - v0.0.4+9firebase_app_check_web - v0.0.5+15cloud_functions_web - v4.2.17cloud_functions_platform_interface - v5.1.9firebase_storage_web - v3.2.18firebase_storage_platform_interface - v4.1.9firebase_performance_platform_interface - v0.1.1+9firebase_performance_web - v0.1.0+15Update a dependency to the latest release.
FEAT: bump Firebase iOS SDK to 12.8.0 (#17947).
REFACTOR: upgrade project to remove warnings from Flutter 3.7 (#10344).
FIX: fix crash that could occur when using transactions (#10184).
FEAT: bump Firebase iOS SDK to 12.6.0 (#17857).
Packages with breaking changes:
getToken method (#18290). (b37722db)Packages with breaking changes:
Packages with other changes:
firebase_core - v4.9.0firebase_core_platform_interface - v7.0.1firebase_core_web - v3.7.0_flutterfire_internals - v1.3.71cloud_firestore - v6.4.1cloud_firestore_platform_interface - v8.0.1cloud_firestore_web - v5.4.1cloud_functions - v6.3.1cloud_functions_platform_interface - v6.0.1cloud_functions_web - v5.1.7firebase_ai - v3.12.1firebase_analytics - v12.4.1firebase_analytics_platform_interface - v6.0.1firebase_analytics_web - v0.6.1+7firebase_app_check - v0.4.4+1firebase_app_check_platform_interface - v0.4.0+1firebase_app_check_web - v0.2.4+2firebase_app_installations - v0.4.2+2firebase_app_installations_platform_interface - v0.1.4+70firebase_app_installations_web - v0.1.7+7firebase_auth - v6.5.1firebase_auth_platform_interface - v9.0.1firebase_auth_web - v6.2.1firebase_crashlytics - v5.2.2firebase_crashlytics_platform_interface - v3.8.22firebase_data_connect - v0.3.0+2firebase_database - v12.4.1firebase_database_platform_interface - v0.4.0+1firebase_database_web - v0.2.7+8firebase_in_app_messaging - v0.9.2+2firebase_in_app_messaging_platform_interface - v0.2.5+22firebase_messaging - v16.2.2firebase_messaging_platform_interface - v4.7.11firebase_messaging_web - v4.1.7firebase_ml_model_downloader - v0.4.2+2firebase_ml_model_downloader_platform_interface - v0.1.5+22firebase_performance - v0.11.4+1firebase_performance_platform_interface - v0.2.0+1firebase_performance_web - v0.1.8+7firebase_remote_config - v6.5.1firebase_remote_config_platform_interface - v3.0.1firebase_remote_config_web - v1.10.8firebase_storage - v13.4.1firebase_storage_platform_interface - v6.0.1firebase_storage_web - v3.11.7Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
_flutterfire_internals - v1.3.71cloud_firestore - v6.4.1cloud_firestore_platform_interface - v8.0.1cloud_firestore_web - v5.4.1cloud_functions - v6.3.1cloud_functions_platform_interface - v6.0.1cloud_functions_web - v5.1.7firebase_ai - v3.12.1firebase_analytics - v12.4.1firebase_analytics_platform_interface - v6.0.1firebase_analytics_web - v0.6.1+7firebase_app_check - v0.4.4+1firebase_app_check_platform_interface - v0.4.0+1firebase_app_check_web - v0.2.4+2firebase_app_installations - v0.4.2+2firebase_app_installations_platform_interface - v0.1.4+70firebase_app_installations_web - v0.1.7+7firebase_auth - v6.5.1firebase_auth_platform_interface - v9.0.1firebase_auth_web - v6.2.1firebase_crashlytics - v5.2.2firebase_crashlytics_platform_interface - v3.8.22firebase_data_connect - v0.3.0+2firebase_database - v12.4.1firebase_database_platform_interface - v0.4.0+1firebase_database_web - v0.2.7+8firebase_in_app_messaging - v0.9.2+2firebase_in_app_messaging_platform_interface - v0.2.5+22firebase_messaging - v16.2.2firebase_messaging_platform_interface - v4.7.11firebase_messaging_web - v4.1.7firebase_ml_model_downloader - v0.4.2+2firebase_ml_model_downloader_platform_interface - v0.1.5+22firebase_performance - v0.11.4+1firebase_performance_platform_interface - v0.2.0+1firebase_performance_web - v0.1.8+7firebase_remote_config - v6.5.1firebase_remote_config_platform_interface - v3.0.1firebase_remote_config_web - v1.10.8firebase_storage - v13.4.1firebase_storage_platform_interface - v6.0.1firebase_storage_web - v3.11.7REFACTOR(messaging,web): convert classes to extension types for improved interop (#17820).
Update a dependency to the latest release.
FIX: fix aggregated count to use the current query and not only the collection on Web (#9824).
FIX(firestore,web): ensure exact same streams are not unsubscribed (#13032).
DOCS(firebase_remote_config): add documentation what is returned when the key does not exist for getBool, getInt, getDouble and getString (#10573).
FIX(firestore,web): ensure streams are removed on "hot restart" (#12913).
BREAKING REFACTOR(firebaseai): Removed deprecated Imagen methods and types due to Imagen models being shut down (#18577).
FIX: fix a query error in Flutter Web that was affecting the parsing of ancient dates (#9633).
FEAT: bump Firebase JS SDK to 12.9.0 (#18043).
FIX(crashlytics): update exception reason to ensure it does not produce incorrect value in Firebase console (#12053).
FIX: fix queryGet() & namedQueryGet(). Check if query is [NSNull null] value (#9410).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Your coding agent can read these notes before it upgrades. Set up the MCP server →