Firebase JS SDK release notes, breaking changes, and upgrade notes.
Firebase client SDK for web and Node.js StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.
Firebase JS SDK 13.3.0 adds preview support for Gemini TTS speech metadata and Firestore Pipeline window functions. It also fixes several issues involving AI instance options and prompt feedback, browser CDN compatibility, Firestore snapshots and transactions, and TypeScript version diagnostics.
affected
The release affects Firebase JS SDK users, particularly Gemini TTS and Firestore Pipeline users, Remote Config users relying on SSR hydration or server templates, and users of the compat CDN bundles.
action
Review any use of the deprecated Remote Config options and plan to stop relying on SSR hydration or fetching server templates from client apps.
release_signals
!Deprecates `RemoteConfigOptions.templateId` and `RemoteConfigOptions.initialFetchResponse`; Remote Config SSR hydration is no longer supported, and client apps cannot fetch `firebase-server` templates. The options are planned for removal in a future major release.
+Adds preview `SpeechMetadata` and `TextPart.speechMetadata` to specify speaker and vocal style when generating speech with Gemini TTS models.
+Adds preview support for window functions in Firestore Pipelines.
This release introduces Crashlytics for public preview and graduates Firestore Pipeline Search from public preview to general availability. It also updates Auth token refresh timing to match documented behavior and fixes several Auth promise and operation-cancellation errors.
affected
Firebase JS SDK users can try Crashlytics in public preview, use Pipeline Search as a generally available feature, and receive Auth reliability and token-refresh updates.
release_signals
+Introduces Firebase Crashlytics for public preview.
+Graduates Firestore Pipeline Search from public preview to general availability.
This major release introduces breaking changes to the AI features, including refactored APIs and removal of deprecated functionality. It also adds support for BSON types and updates the default AI model.
affected
Users of the Firebase JavaScript SDK, especially those using AI features, are affected by breaking changes and deprecations.
action
Review the breaking changes and migration steps, update your code accordingly, and test thoroughly.
release_signals
-Refactored `TemplateGenerativeModel.generateContent` and `TemplateGenerativeModel.generateContentStream` to accept a unified `TemplateRequest` object (`{ templateId, templateVariables, toolConfig? }`) as the first parameter. Made `templateVariables` required in both `TemplateRequest` and `StartTemplateChatParams`.
firebase@12.19.0mediumfeatureSep 9, 2026
firebase@12.19.0
This release includes fixes for issues related to function calling in the AI module, improvements to client-side validation for structured outputs, and enhancements to authentication persistence handling.
affected
Developers using Firebase AI, Firestore, and Authentication modules may be affected by the fixes and improvements.
action
Update to the latest version to benefit from the fixes and new features.
release_signals
+Support for conversion and serialization of Temporal.Instant to Firestore's Timestamp
+Fixed client-side validation to accept both `application/json` and `text/x.enum` for structured outputs
This release includes updates to the Firebase JavaScript SDK, focusing on improvements to error handling in Functions and the removal of Imagen methods due to its shutdown. Developers are encouraged to migrate to Gemini Image models.
affected
Developers using Imagen models or Firebase Functions error handling are affected.
action
Migrate to Gemini Image models and update your Firebase Functions error handling code.
release_signals
-Imagen methods and types have been removed due to Imagen models being shut down. Migration to Gemini Image models is required.
+Added more details to `FunctionsError`, including HTTP status code in the `message` field and `url` in `customData`.
firebase@12.17.1mediumfeatureAug 4, 2026
firebase@12.17.1
This release includes fixes for database-compat and data-connect, including a regression fix for peerDeps in standalone bundles and alignment of SQL Connect Stream Transport exponential backoff parameters.
affected
Users of Firebase JavaScript SDK, particularly those using database-compat or data-connect, may be affected by the fixes and updates.
action
Update to firebase@12.17.1 to benefit from the latest fixes and improvements.
release_signals
+Added gRPC request header for platform name and SDK version to enable metrics collection in cloud monitoring.
This release introduces text-to-speech capabilities for non-Live API models, deprecates `VertexAIBackend` in favor of `AgentPlatformBackend`, and removes the ability to call `initializeAppCheck` without a `provider`. Additionally, it includes a fix for a ReDoS vulnerability in FirebaseError template replacement.
affected
Users relying on `initializeAppCheck` without a `provider` or using `VertexAIBackend` are affected.
action
Update your code to include a `provider` when calling `initializeAppCheck` and migrate from `VertexAIBackend` to `AgentPlatformBackend`.
release_signals
-Removed the ability to call `initializeAppCheck` without a `provider`. This change affects users who relied on this functionality.
This release introduces a simplified initialization for App Check and resolves conflicts between Auth and AppCheck when using ReCAPTCHA Enterprise. It also includes updates to Firestore's offline pipeline and improvements to Auth's referrer policy.
affected
Developers using App Check, Auth, and Firestore are affected by these changes.
action
Update to the latest version to benefit from new features and fixes.
release_signals
!Deprecated `GoogleMaps.enableWidget` in the AI module.
+Added ability to call `initializeAppCheck` without a `provider`, defaulting to `ReCaptchaEnterpriseProvider`.
+Merged offline pipeline implementation in Firestore with a minor API change.
This release introduces new APIs for hybrid inference and FCM registration, deprecates older APIs, and includes several bug fixes and improvements.
affected
Developers using FCM registration or hybrid inference features are affected.
action
Update to the new APIs for FCM registration and hybrid inference.
release_signals
!Deprecated old API for creating and deleting FCM registration.
+Added `initializeDeviceModel()` method for explicit initialization of on-device model in hybrid mode.
+Added minimum and maximum `FieldValue` operations.
firebase@12.13.0highfeatureMay 7, 2026
firebase@12.13.0
This release introduces new features in Firebase AI and Firebase SQL Connect, including support for resuming LiveSessions, context window compression, and enhanced streaming transport optimizations.
affected
Developers using Firebase AI and Firebase SQL Connect will benefit from new features and optimizations.
action
Update to the latest version to take advantage of new features and improvements.
release_signals
+Added `LiveSession.resumeSession()` to allow resuming a previous `LiveSession`.
+Added `contextWindowCompression` feature.
+Added support for `ImageConfig` (aspect ratio and size).
+Expanded `FinishReason` values to include all currently available values provided by the models.
v12.12.1mediumfeatureApr 20, 2026
firebase@12.12.1
This release updates the Firebase JavaScript SDK, primarily focusing on the @firebase/ai module. It includes fixes for TypeScript builds and marks certain features as generally available.
affected
Developers using the @firebase/ai module, particularly those working with TypeScript, are affected.
action
Update to the latest version to benefit from the fixes and feature updates.
release_signals
+Code execution and URL context features are now generally available and no longer in public preview.
This release introduces new features in Firebase AI, Data Connect, and Pipelines, including support for streaming, chat functionality, and logical expressions. Several deprecations and breaking changes are also announced.
affected
Developers using Imagen models, hybrid inference mode, or the Beta API for Pipelines are affected.
action
Migrate from Imagen models to Gemini Image models and update code to handle breaking changes in the Beta API.
release_signals
-Beta API Breaking Change: Changed `Type` string union to be a raw string.
!All Imagen models are deprecated and will shut down as early as June 2026.
firebase@12.11.0highbreakingfeatureMar 19, 2026
firebase@12.11.0
This release introduces new array expression support in Firestore and adds `responseJsonSchema` to `GenerationConfig`. It also includes internal changes and dependency updates.
affected
Developers using Firestore Pipelines API (Beta) and those leveraging array expressions in Firestore are affected.
action
Review Firestore Pipelines API usage and update code to handle deferred validation if applicable.
release_signals
-Defer pipeline user data validation from initialization to `execute()` in Firestore Pipelines API (Beta API breaking change).
+Added `responseJsonSchema` to `GenerationConfig`.
-Removed the previously deprecated `VertexAIBackend` (and `BackendType.VERTEX_AI`). Use `AgentPlatformBackend` (and `BackendType.AGENT_PLATFORM`) instead. The default location for `AgentPlatformBackend` is `global`, whereas the default location for `VertexAIBackend` was `us-central1`.
-Refactored `Part` into a discriminated union with explicit `type` properties, introduced `UnknownPart` for raw wire and user-provided inputs, stripped `type` discriminators on wire egress, and ensured defensive deep copying for chat history.
!Deprecated `candidateCount`, `temperature`, `topP`, `topK`, `presencePenalty`, and `frequencyPenalty` in both `GenerationConfig` and `LiveGenerationConfig`. These parameters are unsupported in Gemini 3.x and later models.
+Added support for BSON types.
+Exported a `ChatSession` interface instead of the `ChatSession` class.
+Updated default hybrid-in-cloud model to `gemini-3.5-flash-lite`.
migration_steps2 steps
01Replace `VertexAIBackend` with `AgentPlatformBackend` and specify the location if needed, e.g., `getAI(app, { backend: new AgentPlatformBackend('us-central1') })`.
02Update calls to `TemplateGenerativeModel.generateContent` and `TemplateGenerativeModel.generateContentStream` to use the new `TemplateRequest` object format.
!Fixed a ReDoS vulnerability in FirebaseError template replacement.
!Deprecated `VertexAIBackend` in favor of `AgentPlatformBackend` to reflect the renaming of Vertex AI to Gemini Enterprise Agent Platform.
+Added support for text-to-speech capabilities (both single- and multi-speaker configurations) for non-Live API models (e.g., Gemini TTS models).
+Changed the HTTP/2 flow control window size from 64 KB to 256 KB for Node environments.
+Added a `grpcFlowControlWindow` configuration option to `FirestoreSettings` for Node environments.
migration_steps1 steps
01To use `us-central1` with `AgentPlatformBackend`, specify `getAI(app, { backend: new AgentPlatformBackend('us-central1') })` when initializing the SDK.
Added support for array expressions `arrayFirst`, `arrayFirstN`, `arrayLast`, `arrayLastN`, `arrayMinimum`, `arrayMinimumN`, `arrayMaximum`, `arrayMaximumN`, `arrayIndexOf`, `arrayLastIndexOf`, and `arrayIndexOfAll` in Firestore.