NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #881 most downloaded on pub.dev
Flutter plugin for Firebase Database, a cloud-hosted NoSQL database with realtime data syncing across Android and iOS clients, and offline access.
Latest stable
13.0.1
Last release 25 days ago
23 Oct 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
10 years old
225 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
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 →
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
REFACTOR(platform_interface): replace Flutter UI and foundation imports with package:meta (#18604).
FIX: Fix MissingPluginException caused by malformed EventChannel name. (#7859).
MissingPluginException caused by malformed EventChannel name. (#7859).MissingPluginException caused by malformed EventChannel name. (#7859). (b69be414)FIX: bump Android compileSdkVersion to 31 (#7726).
compileSdkVersion to 31 (#7726).NSNull should be converted to nil on iOS/macOS (#7810).setUserProperty should now accept null as a valid value on Android (#7735).REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.FIX: ensure setDefaultEventParameters() API throws stating not supported on web. (#7522).
setDefaultEventParameters() API throws stating not supported on web. (#7522).DOCS(auth): clarify behavior of password reset email with email enumeration protection enabled (#18296).
FIX: use jsify() with event parameters for logEvent() so they are sent (#7509).
jsify() with event parameters for logEvent() so they are sent (#7509).databaseURL can sometimes be ignored (fixes #7502) (#7510).path getter for Query (fixes #7495).setPersistenceEnabled to reflect updated return type (fixes #7496) (#7501).Bump platform interface a major version due to pigeon dependency update
Bump platform interface a major version due to pigeon dependency update
REFACTOR: move all packages to workspace (#18182). (6cdfcb10)
FIX: update core, auth and app-check logic so internal resources on method channels are properly disposed (#18268). (a0de4ed8)
FEAT(auth,android): add revokeAccessToken support for Android (#18206) (#18207). (7e0a2227)
Note: This release has breaking changes.
Realtime Database has been fully reworked to bring the plugin inline with the federated plugin setup, a more familiar API, better documentation and many more unit and end-to-end tests.
General
Map with int keys would crash.FirebaseDatabase
FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().reference() has now been deprecated in favor of ref().ref(), which allows you to provide an optional path to any database node rather than calling child().useDatabaseEmulator().refFromURL().setPersistenceEnabled() is now synchronous.setPersistenceCacheSizeBytes() is now synchronous.setLoggingEnabled() is now synchronous.DatabaseReference
parent is now a getter (inline with the JavaScript API).root is now a getter (inline with the JavaScript API).set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().applyLocally property on runTransaction.Query
once() now accepts an optional DatabaseEventType (rather than just subscribing to the value).limitToFirst() now asserts the value is positive.limitToLast() now asserts the value is positive.OnDisconnect
set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().Event
Event class returned from database queries has been renamed to DatabaseEvent.NEW: DatabaseEvent (old Event)
DatabaseEventType is now returned on the event.previousChildKey is now returned on the event (previously called previousSiblingKey).NEW: DatabaseEventType
DatabaseEventType is now returned from a DatabaseEvent.DataSnapshot
.priority getter.hasChild().child()..children getter.
snapshot.value are no longer pre-sorted when using order queries, use .children
if you need to iterate over your value keys in order.TransactionResult
DatabaseError, instead handle errors of a transaction via a Future completion error.NEW: Transaction
Transaction.success(value) return this from inside your TransactionHandler to indicate a successful execution.Transaction.abort() return this from inside your TransactionHandler to indicate that the transaction should be aborted.TransactionHandler
Transaction either via Transaction.success() or Transaction.abort().DatabaseError
DatabaseError class has been removed. Errors are now returned as a FirebaseException inline with the other plugins.FIX: ignore emulator already set error on web (hot restart issue) (#7483).
DEPRECATED: FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().
Realtime Database has been fully reworked to bring the plugin inline with the federated plugin setup, a more familiar API, better documentation and many more unit and end-to-end tests.
General
Fixed an issue where providing a Map with int keys would crash.
FirebaseDatabase
DEPRECATED: FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().
DEPRECATED: reference() has now been deprecated in favor of ref().
NEW: Added support for ref(), which allows you to provide an optional path to any database node rather than calling child().
NEW: Add emulator support via useDatabaseEmulator().
NEW: Add support for refFromURL().
BREAKING: setPersistenceEnabled() is now synchronous.
BREAKING: setPersistenceCacheSizeBytes() is now synchronous.
BREAKING: setLoggingEnabled() is now synchronous.
DatabaseReference
BREAKING: parent is now a getter (inline with the JavaScript API).
BREAKING: root is now a getter (inline with the JavaScript API).
BREAKING: set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.
NEW: Added support for setWithPriority().
NEW: Added support for locally applying transaction results via the applyLocally property on runTransaction.
Query
NEW: once() now accepts an optional DatabaseEventType (rather than just subscribing to the value).
BREAKING: limitToFirst() now asserts the value is positive.
BREAKING: limitToLast() now asserts the value is positive.
OnDisconnect
set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().Event
BREAKING: The Event class returned from database queries has been renamed to DatabaseEvent.
NEW: DatabaseEvent (old Event)
The DatabaseEventType is now returned on the event.
The previousChildKey is now returned on the event (previously called previousSiblingKey).
NEW: DatabaseEventType
A DatabaseEventType is now returned from a DatabaseEvent.
DataSnapshot
NEW: Added support for accessing the priority via the .priority getter.
NEW: Added support for determining whether the snapshot has a child via hasChild().
NEW: Added support for accessing a snapshot child node via child().
NEW: Added support for iterating the child nodes of the snapshot via the .children getter.
snapshot.value are no longer pre-sorted when using order queries, use .children
if you need to iterate over your value keys in order.TransactionResult
BREAKING: The result of a transaction no longer returns a DatabaseError, instead handle errors of a transaction via a Future completion error.
NEW: Transaction
Transaction.success(value) return this from inside your TransactionHandler to indicate a successful execution.Transaction.abort() return this from inside your TransactionHandler to indicate that the transaction should be aborted.TransactionHandler
Transaction either via Transaction.success() or Transaction.abort().DatabaseError
BREAKING: The DatabaseError class has been removed. Errors are now returned as a FirebaseException inline with the other plugins.
FEAT: automatically inject Firebase JS SDKs (#7359).
FIX(cloud_firestore): stop dropping filters, settings and instance on copies (#18819).
FirebaseApp instances from Dart (#6549).Update a dependency to the latest release.
REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
List values would error on transaction result (#7001).Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.7.0cloud_firestore_platform_interface - v8.0.4cloud_firestore_web - v5.7.0cloud_functions_platform_interface - v6.0.4firebase_ai - v3.14.0firebase_auth - v6.5.5firebase_core - v4.12.0cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Packages 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.
cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Note: This release has breaking changes.
REFACTOR: firebase_database_platform_interface (#6668).
Update a dependency to the latest release.
FEAT: support for Firestore Pipelines (#18183).
CHORE: rm deprecated jcenter repository (#6431).
Update a dependency to the latest release.
FIX(iOS): Security Update: Removed root certificates associated with compromised eMudhra intermediate CAs from the embedded trust store.
REFACTOR(firestore): deprecate setIndexConfigurationFromJSON (#18801).
FIX: podspec osx version checking script should use a version range instead of a single fixed version.
REFACTOR: move packages/firebase_database to packages/firebase_database/firebase_database (#5887).
packages/firebase_database to packages/firebase_database/firebase_database (#5887).FIX: return ordered data (#5765).
> Note: This release has breaking changes.
Note: This release has breaking changes.
FIX(firestore,android): avoid ConcurrentModificationException by collecting Firestore instances before termination (#17956).
DOCS: remove incorrect ARCHS in ios examples (#5450).
FEAT(cloud_functions): expose allowInsecureTokenAttachment for Apple debug builds (#18734).
firebase_core.FIX(apple): build on Firebase Apple SDK 13 and require macOS 11 for Swift packages (#18783).
Note: This release has breaking changes.
FEAT(firebaseai): Deprecated candidateCount, temperature, topP, topK, `presence… (#18694).
candidateCount, temperature, topP, topK, `presence… (#18694). (2c1e26fb)FEAT: bump Firebase iOS SDK to 12.8.0 (#17947).
com.android.tools.build & 'com.google.gms:google-services versions (#4269).> Note: This is a security release for Cloud Firestore on Windows. Firebase C++ SDK 13.13.1 builds Firestore from Firebase iOS SDK 12.19.3, which remo…
Note: This is a security release for Cloud Firestore on Windows. Firebase C++ SDK 13.13.1 builds Firestore from Firebase iOS SDK 12.19.3, which removes compromised eMudhra CA roots from Firestore's embedded gRPC root-certificate bundle (firebase-ios-sdk#16930).
- Windows: upgrade to this
firebase_corerelease (orcloud_firestore6.10.2, which requires it). If the build keeps using the old SDK, runflutter clean. If you setFIREBASE_CPP_SDK_DIR, point it at a 13.13.1 SDK.- iOS/macOS were fixed in
firebase_core4.15.1 (BoM 4.20.1).
Packages with breaking changes:
Packages with other changes:
compileSdkVersion to 29 in preparation for upcoming Play Store requirement.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.7Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v3.4.0cloud_firestore_platform_interface - v5.7.0cloud_firestore_web - v2.8.0firebase_analytics - v9.2.1firebase_analytics_platform_interface - v3.2.1firebase_analytics_web - v0.4.1+1firebase_auth - v3.5.0firebase_auth_platform_interface - v6.4.0firebase_auth_web - v4.1.0firebase_core - v1.20.0firebase_core_platform_interface - v4.5.0firebase_messaging_platform_interface - v4.1.0firebase_messaging_web - v3.1.0flutterfire_ui - v0.4.3cloud_firestore_odm - v1.0.0-dev.22cloud_firestore_odm_generator - v1.0.0-dev.22firebase_in_app_messaging - v0.6.0+20firebase_in_app_messaging_platform_interface - v0.2.1+12firebase_crashlytics - v2.8.6firebase_crashlytics_platform_interface - v3.2.12firebase_remote_config - v2.0.13firebase_database_web - v0.2.1+1firebase_remote_config_platform_interface - v1.1.12firebase_database_platform_interface - v0.2.1+12firebase_database - v9.0.20firebase_remote_config_web - v1.1.1firebase_app_installations_web - v0.1.1+1firebase_dynamic_links - v4.3.3firebase_dynamic_links_platform_interface - v0.2.3+8firebase_app_installations_platform_interface - v0.1.1+12firebase_app_installations - v0.1.1+3firebase_messaging - v12.0.1firebase_ml_model_downloader - v0.1.1+3firebase_ml_model_downloader_platform_interface - v0.1.1+12firebase_app_check_platform_interface - v0.0.4+12firebase_app_check - v0.0.6+18firebase_app_check_web - v0.0.6+1cloud_functions_web - v4.3.1cloud_functions - v3.3.3firebase_storage_platform_interface - v4.1.12firebase_storage_web - v3.3.1cloud_functions_platform_interface - v5.1.12firebase_performance_platform_interface - v0.1.1+12firebase_performance - v0.8.2+1firebase_storage - v10.3.3firebase_performance_web - v0.1.1+1firebase_core_web - v1.7.1Packages 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.
cloud_firestore_odm - v1.0.0-dev.22cloud_firestore_odm_generator - v1.0.0-dev.22firebase_in_app_messaging - v0.6.0+20firebase_in_app_messaging_platform_interface - v0.2.1+12firebase_crashlytics - v2.8.6firebase_crashlytics_platform_interface - v3.2.12firebase_remote_config - v2.0.13firebase_database_web - v0.2.1+1firebase_remote_config_platform_interface - v1.1.12firebase_database_platform_interface - v0.2.1+12firebase_database - v9.0.20firebase_remote_config_web - v1.1.1firebase_app_installations_web - v0.1.1+1firebase_dynamic_links - v4.3.3firebase_dynamic_links_platform_interface - v0.2.3+8firebase_app_installations_platform_interface - v0.1.1+12firebase_app_installations - v0.1.1+3firebase_messaging - v12.0.1firebase_ml_model_downloader - v0.1.1+3firebase_ml_model_downloader_platform_interface - v0.1.1+12firebase_app_check_platform_interface - v0.0.4+12firebase_app_check - v0.0.6+18firebase_app_check_web - v0.0.6+1cloud_functions_web - v4.3.1cloud_functions - v3.3.3firebase_storage_platform_interface - v4.1.12firebase_storage_web - v3.3.1cloud_functions_platform_interface - v5.1.12firebase_performance_platform_interface - v0.1.1+12firebase_performance - v0.8.2+1firebase_storage - v10.3.3firebase_performance_web - v0.1.1+1firebase_core_web - v1.7.1FIX(core,web): honour flutterfire_ignore_scripts under dart2wasm (#18806).
ServerValue.increment(delta) (#3109).FIX(core,web): skip hot-restart listener cleanup in profile mode (#18729).
firebase_core.firebase_core.Nothing published for this version
Update lower bound of dart dependency to 2.0.0.
REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.cloud_firestore_odm_generator - v1.0.0-dev.5DOCS: update firestore dartpad example.
FIX(auth,windows): fix a crash that could happen when using sendEmailVerification or sendPasswordResetEmail (#12946).
author: field from pubspec.yamlFEAT: bump Firebase JS SDK to 12.2.1 (#17678).
Updated README instructions for contributing for consistency with other Flutterfire plugins.
REFACTOR(platform_interface): replace Flutter UI and foundation imports with package:meta (#18604).
FIX(remote_config): restores the Apple error mapping and accepts both throttling status spellings (#18458).
TestWidgetsFlutterBinding.ensureInitialized.REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
FIX: fix aggregated count to use the current query and not only the collection on Web (#9824).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
Add missing template type parameter to invokeMethod calls.
invokeMethod calls.Bump platform interface a major version due to pigeon dependency update
Provide a toString implementation for DatabaseError.
toString implementation for DatabaseError.FIX: currentUser is now populated right at the start of the application without needing to wait for authStateChange (#10028).
getDictionaryFromError always returns non nil result even when the parameter is nil.One column per quarter.