Version 26 removes the deprecated namespaced JavaScript API from selected packages. Each migrated package is modular-only: use getX(app?) and root-level helper functions from the package entry point. Namespaced default exports, firebase.<module>(), and Firebase*Types namespaces are removed from those packages.

If you are upgrading from v24 or earlier, complete Migrating to v25 first — v25 TypeScript alignment changes still apply.

• New Architecture requirement
• Platform behavior differences
• firebase-js-sdk API parity improvements
• General pattern
• App
• Machine Learning (ML)
• In-App Messaging
• Installations
• Cloud Messaging
• App Distribution
• Cloud Functions
• Performance Monitoring
• App Check
• Analytics
• Remote Config
• Crashlytics
• Realtime Database
• Cloud Storage
• Authentication
• Cloud Firestore
• Automated migration checklist

From v26 onward, every React Native Firebase package with a native bridge is implemented as a Codegen TurboModule and requires React Native's New Architecture. The legacy bridge modules were removed in the coordinated v26 break.

If you cannot enable New Architecture yet, stay on v25 (or v23 if you still depend on legacy-architecture Cloud Functions — see below).

@react-native-firebase/functions has required New Architecture since v24 (Migrating to v24 — Cloud Functions). v26 extends the same requirement to all remaining native modules.

React Native CLI (Android) — set in android/gradle.properties:

newArchEnabled=true

React Native CLI (iOS) — New Architecture is enabled when RCT_NEW_ARCH_ENABLED=1 during pod install (React Native sets this from newArchEnabled on recent templates). Follow the React Native New Architecture guide for your RN version.

Expo — enable in your app config (Expo SDK 52+):

{
  "expo": {
    "newArchEnabled": true
  }
}

Rebuild native projects after changing this (pod install, clean Android build).

Native builds fail early with explicit guards:

• Android: Gradle scripts print New Architecture support is required for @react-native-firebase/<package> and fail the build.
• iOS: pod install fails with <PodName> requires New Architecture. Enable New Architecture to use this module.

When migrating from firebase-js-sdk web examples, watch for these high-impact runtime divergences:

{/* prettier-ignore */}

Per-package notes also appear in each module's usage page under Platform support.

v26 aligns React Native Firebase modular types and several runtime signatures with firebase-js-sdk where TurboModules removed bridge-forced Promise wrappers. Use this section when porting web SDK examples or when scripted upgrades hit TypeScript or runtime errors.

Migration rule: If a method below is sync, remove await and any .then() / .catch() chain on its return value — sync APIs return void or a value directly; calling .then() on void throws at runtime.

{/* prettier-ignore */}

{/* prettier-ignore */}

{/* prettier-ignore */}

{/* prettier-ignore */}

{/* prettier-ignore */}

For each package listed in this guide:

1. Remove default export / firebase.<module>() usage — import modular helpers from the package root.
2. Replace Firebase*Types namespace imports with root types (InAppMessaging, Installations, FirebaseML, etc.).
3. Prefer free functions (getId(installations), setMessagesDisplaySuppressed(inAppMessaging, enabled)) over instance methods on service objects.

Modular-only in v26: @react-native-firebase/app, @react-native-firebase/ml, @react-native-firebase/in-app-messaging, @react-native-firebase/installations, @react-native-firebase/messaging, @react-native-firebase/app-distribution, @react-native-firebase/functions, @react-native-firebase/perf, @react-native-firebase/app-check, @react-native-firebase/remote-config, @react-native-firebase/crashlytics, @react-native-firebase/database, @react-native-firebase/storage, @react-native-firebase/analytics, @react-native-firebase/auth, and @react-native-firebase/firestore. Other packages may still expose the namespaced API with deprecation warnings; modular imports remain the supported path.

The namespaced API for @react-native-firebase/app has been removed. This package is modular-only — use named exports such as getApp(), initializeApp(), and getUtils().

// Previously (removed)
import firebase from '@react-native-firebase/app';

firebase.app().name;
firebase.initializeApp(options, 'secondary');
firebase.utils().FilePath.DOCUMENT_DIRECTORY;

// Now
import { getApp, initializeApp, getUtils, FilePath } from '@react-native-firebase/app';

getApp().name;
initializeApp(options, 'secondary');
getUtils().FilePath.DOCUMENT_DIRECTORY;
// or
FilePath.DOCUMENT_DIRECTORY;

The namespaced API for @react-native-firebase/ml has been removed. This package is modular-only — use getML(app?).

// Previously (removed)
import firebase from '@react-native-firebase/app';
import ml from '@react-native-firebase/ml';

firebase.ml().app.name;
ml().app.name;

// Now
import { getApp } from '@react-native-firebase/app';
import { getML } from '@react-native-firebase/ml';

getML().app.name; // default app
getML(getApp('secondaryFromNative')).app.name;

The namespaced API for @react-native-firebase/in-app-messaging has been removed. This package is modular-only — use getInAppMessaging() and the root-level helper functions.

There is no firebase/in-app-messaging entry in the firebase-js-sdk modular surface; React Native Firebase follows the same modular service-instance pattern used for other native-only modules.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import inAppMessaging from '@react-native-firebase/in-app-messaging';

await firebase.inAppMessaging().setMessagesDisplaySuppressed(true);
// or
await inAppMessaging().setMessagesDisplaySuppressed(true);

// Now
import {
  getInAppMessaging,
  setMessagesDisplaySuppressed,
} from '@react-native-firebase/in-app-messaging';

await setMessagesDisplaySuppressed(getInAppMessaging(), true);

See In-App Messaging usage for additional examples.

The namespaced API for @react-native-firebase/installations has been removed. This package is modular-only — use getInstallations() and the root-level helper functions.

Modular getInstallations() returns a firebase-js-sdk-shaped Installations object exposing only app. Use modular helper functions instead of instance methods.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import installations from '@react-native-firebase/installations';

const id = await firebase.installations().getId();
// or
const id = await installations().getId();

// Now
import { getInstallations, getId } from '@react-native-firebase/installations';

const installations = getInstallations();
const id = await getId(installations);

See Installations usage for additional examples.

The namespaced API for @react-native-firebase/messaging has been removed. This package is modular-only — use getMessaging() and the root-level helper functions.

Modular getMessaging() returns a firebase-js-sdk-shaped Messaging object. Prefer free functions (getToken(messaging), onMessage(messaging, listener), etc.) over calling methods on the service instance.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import messaging from '@react-native-firebase/messaging';

firebase.messaging().onMessage(message => {
  console.log(message.data);
});
// or
messaging().onMessage(message => {
  console.log(message.data);
});

// Now
import { getMessaging, onMessage } from '@react-native-firebase/messaging';

onMessage(getMessaging(), message => {
  console.log(message.data);
});

// Previously (removed)
await firebase.messaging().setDeliveryMetricsExportToBigQuery(true);

// Now
import {
  getMessaging,
  experimentalSetDeliveryMetricsExportedToBigQueryEnabled,
} from '@react-native-firebase/messaging';

await experimentalSetDeliveryMetricsExportedToBigQueryEnabled(getMessaging(), true);

See Cloud Messaging usage for additional examples.

The namespaced API for @react-native-firebase/app-distribution has been removed. This package is modular-only — use getAppDistribution() and the root-level helper functions.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import appDistribution from '@react-native-firebase/app-distribution';

await firebase.appDistribution().isTesterSignedIn();

// Now
import { getAppDistribution, isTesterSignedIn } from '@react-native-firebase/app-distribution';

const appDistribution = getAppDistribution();
await isTesterSignedIn(appDistribution);

The namespaced API for @react-native-firebase/functions has been removed. This package is modular-only — use getFunctions() and root-level helper functions.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import functions from '@react-native-firebase/functions';

await firebase.functions().httpsCallable('myFn')({ foo: 'bar' });

// Now
import { getFunctions, httpsCallable } from '@react-native-firebase/functions';

const functions = getFunctions();
await httpsCallable(functions, 'myFn')({ foo: 'bar' });

The namespaced API for @react-native-firebase/perf has been removed. This package is modular-only — use getPerformance() and root-level helper functions.

• Trace, HttpMetric, and ScreenTrace start() / stop() now return void synchronously (previously Promise<null>), matching the firebase-js-sdk web PerformanceTrace. The underlying native calls are in-memory, so no await is required — remove any await on these calls.
• startScreenTrace(performance, screenName) and the internal startTrace(name) helper now return the trace instance synchronously instead of a Promise.

The namespaced API for @react-native-firebase/app-check has been removed. This package is modular-only — use getAppCheck() / initializeAppCheck() and root-level helper functions.

• initializeAppCheck(app?, options?) returns AppCheck synchronously (previously Promise<AppCheck>). Native provider setup continues in the background — remove await and do not chain .then().

The namespaced API for @react-native-firebase/analytics has been removed. This package is modular-only — use getAnalytics() and root-level helper functions.

Analytics supports only the default Firebase app (same as before). Calling getAnalytics(secondaryApp) throws.

• logEvent(analytics, …) returns void synchronously (previously Promise<void>). Remove await and .then() chains.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import analytics from '@react-native-firebase/analytics';

await firebase.analytics().logEvent('screen_view', { screen_name: 'Home' });
await analytics().setUserId('user-123');

// Now
import { getAnalytics, logEvent, setUserId } from '@react-native-firebase/analytics';

const analytics = getAnalytics();
logEvent(analytics, 'screen_view', { screen_name: 'Home' });
await setUserId(analytics, 'user-123');

See Analytics usage for additional examples.

The namespaced API for @react-native-firebase/remote-config has been removed. This package is modular-only — use getRemoteConfig() and root-level helper functions.

Modular getRemoteConfig() returns a firebase-js-sdk-shaped RemoteConfig object with app, settings, defaultConfig, fetchTimeMillis, and lastFetchStatus. Use modular helper functions for fetch/activate/getters; assign remoteConfig.settings and remoteConfig.defaultConfig instead of removed modular setConfigSettings() / setDefaults() helpers.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import remoteConfig from '@react-native-firebase/remote-config';

await firebase.remoteConfig().fetchAndActivate();
const value = firebase.remoteConfig().getValue('key').asString();

// Now
import { getRemoteConfig, fetchAndActivate, getValue } from '@react-native-firebase/remote-config';

const remoteConfig = getRemoteConfig();
await fetchAndActivate(remoteConfig);
const value = getValue(remoteConfig, 'key').asString();

See Remote Config usage for additional examples.

The namespaced API for @react-native-firebase/crashlytics has been removed. This package is modular-only — use getCrashlytics() and root-level helper functions.

The namespaced API for @react-native-firebase/database has been removed. This package is modular-only — use getDatabase() and root-level helper functions.

• goOnline(db) and goOffline(db) (and the database instance methods) now return void synchronously (previously Promise<void>), matching firebase-js-sdk. Remove any await on these calls.

The namespaced API for @react-native-firebase/storage has been removed. This package is modular-only — use getStorage() and root-level helper functions.

• UploadTask.pause(), UploadTask.resume(), and UploadTask.cancel() now return boolean synchronously (previously Promise<boolean>), matching firebase-js-sdk task semantics. Remove await, .then(), and .catch() from these control calls and use the returned boolean directly.
• cancel() delegates to the native SDK. Android cancels active uploads; iOS active-upload cancel follows the current Firebase Storage iOS SDK 12.15.0 behavior tracked in firebase-ios-sdk#16353.

The namespaced API for @react-native-firebase/auth has been removed. This package is modular-only — use getAuth() / initializeAuth() and root-level helper functions.

• isSignInWithEmailLink(auth, emailLink) now returns boolean synchronously, matching firebase-js-sdk.
• TotpSecret.generateQrCodeUrl(accountName?, issuer?) now returns string synchronously, matching firebase-js-sdk. When accountName or issuer is omitted, React Native Firebase fills the same defaults from the current user email and Firebase app name.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import auth from '@react-native-firebase/auth';

firebase.auth().signOut();
auth().currentUser;

// Now
import { getAuth, signOut } from '@react-native-firebase/auth';

const auth = getAuth();
await signOut(auth);
auth.currentUser;

The namespaced API for @react-native-firebase/firestore has been removed. This package is modular-only — use getFirestore() / initializeFirestore() and root-level helper functions. The @react-native-firebase/firestore/pipelines subpath export is unchanged.

• initializeFirestore(app, settings, databaseId?) returns Firestore synchronously (previously Promise<Firestore>). Remove await and .then(); settings apply on the native bridge after return.
• TransactionOptions is now exported. runTransaction(firestore, updateFunction, options?) accepts { maxAttempts?: number } and passes the retry limit to the native iOS and Android Firestore SDKs. When options is omitted, the native default applies (5 attempts, matching firebase-js-sdk runTransaction). When maxAttempts is provided explicitly, values below 1 throw synchronously with Max attempts must be at least 1 — the same validation as firebase-js-sdk.
• aggregateFieldEqual() and aggregateQuerySnapshotEqual() are now exported for aggregate query equality checks (firebase-js-sdk parity).
• FieldValue maximum(n) and minimum(n) sentinels from firebase-js-sdk 12.15.0 are not exported yet. Android Firebase Firestore SDK 34.15.0 supports them, but iOS Firebase Firestore SDK 12.15.0 does not expose matching FIRFieldValue factories, so React Native Firebase waits for cross-platform support.

// Previously (removed)
import firebase from '@react-native-firebase/app';
import firestore from '@react-native-firebase/firestore';

firebase.firestore().collection('users').doc('alice').set({ name: 'Alice' });
firestore.FieldValue.serverTimestamp();

// Now
import {
  getFirestore,
  collection,
  doc,
  setDoc,
  serverTimestamp,
} from '@react-native-firebase/firestore';

const db = getFirestore();
await setDoc(doc(collection(db, 'users'), 'alice'), {
  name: 'Alice',
  createdAt: serverTimestamp(),
});

See Firestore usage for additional examples.

Use this section when running scripted or agent-assisted upgrades to v26 for modular-only packages.

# Bump all @react-native-firebase/* packages to v26 together (monorepo versions are aligned)
yarn add @react-native-firebase/app@^26.0.0 …
cd ios && pod install

For each modular-only package you use:

Also remove await, .then(), and .catch() from UploadTask.pause(), UploadTask.resume(), and UploadTask.cancel(). For Firestore transactions, import TransactionOptions when you pass { maxAttempts } (omit options for the default 5 retries; do not pass 0 or negative values). Import aggregateFieldEqual() / aggregateQuerySnapshotEqual() for aggregate equality checks.

yarn compile
yarn tests:jest packages/<pkg>/__tests__