Firebase FAQ

What is a Firebase project?

A Firebase project is the top-level entity for Firebase. In a project, you can register your Apple, Android, or web apps. After you register your apps with Firebase, you can add the product-specific Firebase SDKs to your app, like Analytics, Cloud Firestore, Crashlytics, or Remote Config.

You should register your Apple, Android, and web app variants within a single Firebase project. You can use multiple Firebase projects to support multiple environments, such as development, staging, and production.

Here are some resources for learning more about Firebase projects:

• Understand Firebase projects — provides brief overviews of several important concepts about Firebase projects, including their relationship with Google Cloud and the basic hierarchy of a project and its apps and resources.
• General best practices for setting up Firebase projects — provides general, high-level best practices for setting up Firebase projects and registering your apps with a project so that you have a clear development workflow that uses distinct environments.

Note that for all Firebase projects, Firebase automatically adds a label of firebase:enabled within the Labels page for your project in the Google Cloud console. Learn more about this label in our FAQ.

What is a Google Cloud organization?

A Google Cloud organization is a container for Google Cloud projects (including Firebase projects). This hierarchy enables better organization, access management, and auditing of your Google Cloud and Firebase projects. For more information, refer to Creating and Managing Organizations.

How do I add Firebase to an existing Google Cloud project?

You may have existing Google Cloud projects managed through the Google Cloud console or the Google APIs console.

You can add Firebase to these existing Google Cloud projects using any of the following options:

• Using the Firebase console.
• Using a programmatic option:
  • Call the Firebase Management REST API endpoint projects.addFirebase.
  • Run the Firebase CLI command firebase projects:addfirebase.
  • Use Terraform.

Learn more details about adding Firebase to a Google Cloud project.

How does Firebase's integration with Google Cloud work?

Firebase is deeply integrated with Google Cloud. Projects are shared between Firebase and Google Cloud, so projects can have Firebase services and Google Cloud services enabled. You can access the same project from the Firebase console or the Google Cloud console. Specifically:

• Certain Firebase products are backed directly by Google Cloud, such as Cloud Storage for Firebase. The list of products backed by Google Cloud will continue to grow over time.
• Many of your settings, including collaborators and billing information, are shared by Firebase and Google Cloud. Your usage of both Firebase and Google Cloud appears on the same bill.

In addition, when you upgrade to the pay-as-you-go Blaze pricing plan, you can use any of Google Cloud's world-class Infrastructure-as-a-Service and APIs directly inside your Firebase project, at standard Google Cloud pricing. You can also export data from Google Cloud directly to BigQuery for analysis. To learn more, see Link BigQuery with Firebase.

There are many security-enhancing, latency-improving, and time-saving benefits to using Google Cloud with Firebase (versus other, cloud services that are not co-located). Check out the Google Cloud site for more details.

Why does my Google Cloud project have a label of firebase:enabled?

In the Labels page for your project in the Google Cloud console, you may see a label of firebase:enabled (specifically, a Key of firebase with a Value of enabled).

Firebase automatically added this label because your project is a Firebase project, which means that your project has Firebase-specific configurations and services enabled for it. Learn more about the relationship between Firebase projects and Google Cloud.

We strongly recommend that you don't modify or delete this label. This label is used by Firebase and Google Cloud to list your Firebase projects (for example, using the REST API projects.list endpoint or in menus within the Firebase console).

Be aware that manually adding this label to your list of project labels does NOT enable Firebase-specific configurations and services for your Google Cloud project. To do that, you need to add Firebase using the Firebase console (or, for advanced use cases, using the Firebase Management REST API or the Firebase CLI).

Why is the Firebase console failing to load a list of my existing Google Cloud projects?

This FAQ is most often applicable if you're trying to "add Firebase" to an existing Google Cloud project using the Firebase console and you have access to many thousands of Google Cloud projects.

The Firebase console isn't built to load many thousands of Google Cloud projects. Instead, we recommend using the Firebase CLI, REST API, or Terraform to "add Firebase" to your existing Google Cloud project.

Also, you might want to review the FAQ "Why isn't my Firebase project showing up in my list of Firebase projects?"

Why isn't my Firebase project showing up in my list of Firebase projects?

This FAQ is applicable if you don't see your Firebase project in the following places:

• In a list of projects that you're viewing within the Firebase console
• In the response from calling the REST API projects.list endpoint
• In the response from running the Firebase CLI command firebase projects:list

Try these troubleshooting steps:

1. First, try accessing your project by visiting the project's URL directly. Use the following format:
   https://console.firebase.google.com/project/PROJECT-ID/overview
2. If you can't access the project or receive permissions errors, check the following:
   • Make sure that you're signed into Firebase using the same Google Account that has access to the project. You can sign in and out of the Firebase console via your account avatar in the top-right corner of the console.
   • Check if you can view the project in the Google Cloud console.
   • Make sure that your project has the label firebase:enabled in the Labels page for your project in the Google Cloud console. Firebase and Google Cloud use this label to list your Firebase projects. If you don't see this label but the Firebase Management API is enabled for your project, then manually add the label (specifically, a Key of firebase with a Value of enabled).
   • Make sure that you're assigned one of the basic IAM roles (Owner, Editor, Viewer) or a role that has Firebase-related permissions in it, for example a Firebase predefined role. You can view your role(s) in the IAM page of the Google Cloud console.
   • If your project belongs to a Google Cloud organization, you may require additional permissions to see the project listed in the Firebase console. Contact the person who manages your Google Cloud organization to give you the appropriate role to view the project, for example the Browser role.

If none of the troubleshooting steps above enable you to see your project in a list of Firebase projects, contact Firebase Support.

How many projects can I have per Google Account (email address)?

• Spark pricing plan: Project-creation quota is limited to a small number of projects (usually around 5-10).
• Blaze pricing plan: Project-creation quota is still limited, but it may increase with the linking of a Cloud Billing account in good standing.

Note the following about the limit on project-creation quota:

• This limit is not specific to Firebase. Firebase's limits on project quota are the same as those for Google Cloud.
• In the rare case that's it's needed, you can request an increase in project quota.
• The complete deletion of a project requires 30 days and counts toward project quota until the project is fully deleted.

Learn about Firebase's recommended general best practices for setting up Firebase projects.

How many Firebase Apps can I have in a Firebase project?

A Firebase project is a container for Firebase Apps across Apple, Android, and web. Firebase restricts the total number of Firebase Apps within a Firebase project to 30.

After this number, performance starts to degrade (especially for Google Analytics) and eventually, at a higher number of apps, some product functionality stops working. Additionally, if you use Google sign-in as an authentication provider, an underlying OAuth 2.0 client ID is created for each app in your project. There's a limit of around 30 client IDs that can be created within a single project.

You should ensure that all Firebase Apps within a single Firebase project are platform variants of the same application from an end-user perspective. For example, if you develop a white-label application, each independently labeled app should have its own Firebase project, but the Apple and Android versions of that label can be in the same project. Read more detailed guidance in our general best practices for setting up Firebase projects.

In the rare case your project requires more than 30 apps, you can request an app limit increase. Your project must be on the Blaze pricing plan to make this request. Visit the Google Cloud console to make your request and have it evaluated. Learn more about quota management in the Google Cloud documentation.

What happens if I tag my project as a "production" environment?

In the Firebase console, you can tag your Firebase projects with their environment type, either as Production or Unspecified (non-prod) environments.

Tagging your project as an environment type has no effect on how your Firebase project works or its features. However, the tagging can help you and your team manage your various Firebase projects for the app lifecycle.

If you tag your project as a production environment, we add a brightly colored Prod tag to the project in the Firebase console, reminding you that any changes could affect your associated production apps. In the future, we might add more features and safeguards for Firebase projects tagged as production environments.

To change the environment type of your Firebase project, go to settings Project settings > General, then in the Your project card under Environment, click edit to change the environment type.

Where can I find the App ID for my Firebase app?

In the Firebase console, go to your settings Project settings. Scroll down to the Your apps card, then click on the desired Firebase App to view the app's information, including its App ID.

Here are some example App ID values:

• Firebase iOS Apps: 1:1234567890:ios:321abc456def7890
• Firebase Android Apps: 1:1234567890:android:321abc456def7890
• Firebase Web Apps: 1:1234567890:web:321abc456def7890

What are the prerequisites for linking Google Play / AdMob / Google Ads / BigQuery to my Firebase project or app?

• For linking your Google Play account, you need the following:
  • Either of the following Firebase roles: Owner or Firebase Admin
  • Either of the following Google Play access levels: account Owner or Admin
• For linking your AdMob app, you need to be both a Firebase project owner and an AdMob administrator.
• For linking your AdWords account, you need to be both a Firebase project owner and an AdWords administrator.
• For linking your BigQuery project, you need to be the Firebase project owner.

How do I assign a project member a role, like the Owner role?

To manage the role(s) assigned to each project member, you must be an Owner of the Firebase project (or be assigned a role with the permission resourcemanager.projects.setIamPolicy).

Here are the places where you can assign and manage roles:

• The Firebase console offers a simplified way to assign roles to project members in the settings Settings > Users and permissions tab. You can assign any of the basic roles (Owner, Editor, Viewer), the Firebase Admin/Viewer roles, or any of the Firebase predefined product-category roles.
• The Google Cloud console offers an expansive set of tools to assign roles to project members in the IAM & Admin IAM page. You can also create and manage custom roles, as well as give service accounts access to your project.

  Note that in the Google Cloud console, project members are called principals.

If the Owner of your project can no longer perform the tasks of an Owner (for example, the person left your company) and your project isn't managed via a Google Cloud organization (see next paragraph), you can contact Firebase Support and check with them about how to request access to the Firebase project.

Note that if a Firebase project is part of a Google Cloud organization, it may not have an Owner. If you're unable to find an Owner for your Firebase project, contact the person who manages your Google Cloud organization to assign an Owner for the project.

How do I find the Owner of a Firebase project?

You can view project members and their roles in the following places:

• If you have access to the project in the Firebase console, you can view the list of project members, including Owners, in the Users and permissions page of the Firebase console.
• If you do not have access to the project in the Firebase console, check if you have access to the project in the Google Cloud console. You can view the list of project members, including Owners, in the IAM page of the Google Cloud console.

If the Owner of your project can no longer perform the tasks of an Owner (for example, the person left your company) and your project isn't managed via a Google Cloud organization (see next paragraph), you can contact Firebase Support to have a temporary Owner assigned.

Note that if a Firebase project is part of a Google Cloud organization, it may not have an Owner. Instead, the person who manages your Google Cloud organization can perform many tasks that an Owner can do. However, to perform several Owner-specific tasks (like assigning roles or managing Google Analytics properties), the administrator may need to assign themselves the actual Owner role to perform those tasks. If you're unable to find an Owner for your Firebase project, contact the person who manages your Google Cloud organization to assign an Owner for the project.

Why or when should I assign a project member the Owner role?

To ensure proper management of a Firebase project, it must have an Owner.

Project members with the Owner role are often the only project members who can do administrative tasks or receive important notifications:

• Project members with the Owner role are often the only members who can perform important administrative actions (like assigning roles and managing Google Analytics properties), and Firebase Support can only fulfill administrative requests from demonstrated project Owners.
• Project members with the Owner role are often the only members who (by default) receive notifications about changes to the project or products (like billing and legal changes, deprecations of features, etc.). You can optionally customize your project's "essential contacts" if you want specific or additional project members to receive notifications.

After you set up the Owner(s) for a Firebase project, it's important to keep those assignments up-to-date.

Note that if a Firebase project is part of a Google Cloud organization, the person who manages your Google Cloud organization can perform many tasks that an Owner can do. However, for several Owner-specific tasks (like assigning roles or managing Google Analytics properties), the administrator may need to assign themselves the actual Owner role to perform those tasks.

I don't think that I have a Firebase project, but I got an email about one. How do I access this project?

The email you received should contain a link to open your Firebase project. Clicking the link in the email should open the project in the Firebase console.

If you're not able to open the project in the link, make sure that you're signed into Firebase using the same Google Account that received the email about the project. You can sign in and out of the Firebase console via your account avatar in the top-right corner of the console.

Note that if you're the administrator of a Google Cloud organization, you may be notified about changes to Firebase projects inside your organization. However, you may not have sufficient permissions to open the Firebase project. In these cases, the simplest solution is to assign yourself the actual Owner role to open the project and perform the required actions. Learn more about why and when to assign the Owner role.

What are the supported browsers for accessing the Firebase console?

The Firebase console can be accessed from recent versions of popular desktop browsers such as Chrome, Firefox, Safari and Edge. Mobile browsers are not fully supported.

I can load the Firebase console, but why can't I find or access my Firebase project?

This FAQ is applicable if you're experiencing either of the following issues:

• The Firebase console returns an error page that says your project may not exist or that you don't have access to the project.
• The Firebase console doesn't display your project even when you enter its project ID or project name in the console's search field.

Try these troubleshooting steps:

1. First, try accessing your project by visiting the project's URL directly. Use the following format:
   https://console.firebase.google.com/project/PROJECT-ID/overview
2. If you still can't access the project or receive permissions errors, check the following:
   • Make sure that you're signed into Firebase using the same Google Account that has access to the project. You can sign in and out of the Firebase console via your account avatar in the top-right corner of the console.
   • Make sure that the Firebase Management API is enabled for the project.
   • Make sure that you're assigned one of the basic IAM roles (Owner, Editor, Viewer) or a role that has Firebase-related permissions in it, for example a Firebase predefined role. You can view your role(s) in the IAM page of the Google Cloud console.
   • If your project belongs to a Google Cloud organization, you may require additional permissions to see the project listed in the Firebase console. Contact the person who manages your Google Cloud organization to give you the appropriate role to view the project, for example the Browser role.

If none of the troubleshooting steps above enable you to find or access your project, contact Firebase Support.

Why is the Firebase console not loading for me?

This FAQ is applicable if you're experiencing any of the following issues:

• A page in the Firebase console never finishes loading.
• Data within a page doesn't load as expected.
• You receive browser error messages when loading the Firebase console.

Try these troubleshooting steps:

1. Check the Console row of the Firebase Status Dashboard for any possible service interruptions.
2. Make sure that you're using a supported browser.
3. Try to load the Firebase console in an incognito or private window.
4. Disable all browser extensions.
5. Verify that the network connection is not blocked by ad blocker, antivirus, proxy, firewall, or other software.
6. Try loading the Firebase console using a different network or device.
7. If using Chrome, check the Developer Tools Console for any errors.

If none of the troubleshooting steps above resolve the issue, contact Firebase Support.

How is my Firebase console language determined?

The language setting for the Firebase console is based on the language selected in your Google Account settings.

To change your language preference, see Change language.

The Firebase console supports the following languages:

• English
• Brazilian Portuguese
• French
• German
• Indonesian
• Japanese
• Korean
• Russian
• Simplified Chinese
• Spanish
• Traditional Chinese

What roles and permissions does the Firebase console support?

The Firebase console and Google Cloud console use the same underlying roles and permissions. Learn more about roles and permissions in the Firebase IAM documentation.

Firebase supports the fundamental (basic) roles of Owner, Editor, and Viewer:

• A project Owner can add other members to the project, set up integrations (project linking to services like BigQuery or Slack), and has full edit access for the project.
• A project Editor has full edit access for the project.
• A project Viewer has only read access for the project. Note that the Firebase console does not hide/disable edit UI controls from project Viewers, but these operations will fail for project members assigned the Viewer role.

Firebase also supports:

• Firebase predefined roles — Curated Firebase-specific roles that enable more granular access control than the basic roles of Owner, Editor, and Viewer.
• Custom roles — Fully customized IAM roles that you create to tailor a set of permissions that meet the specific requirements of your organization.

Why do Local Emulator Suite logs show an error starting with "Multiple projectIds are not recommended in single project mode"?

This message means the Local Emulator Suite has detected it may be running a particular product emulator using different project IDs. This may indicate a misconfiguration, and can cause issues when emulators try to communicate with one another, and when you try to interact with emulators from your code. If project IDs don't match, it often appears that data is missing, since data stored in emulators is keyed to projectID, and interoperability depends on matching project IDs.

This has been a common source of confusion among developers, so by default the Local Emulator Suite will now only allow running with a single project ID, unless you specify otherwise in the firebase.json configuration file. If an emulator detects more than one project ID, it will log a warning and potentially throw a fatal error.

Check your project ID declaration(s) for mismatches in:

• The default project set at the command line. By default, the project ID will be taken on startup from the project selected with firebase init or firebase use. To view the list of projects (and see which one is selected) use firebase projects:list.
• Unit tests. The project ID is often specified in calls to the Rules Unit Testing library methods initializeTestEnvironment or initializeTestApp. Other testing code may initialize with initializeApp(config).
• The command line --project flag. Passing the Firebase CLI --project flag overrides the default project. You'll need to ensure the value of the flag matches the project ID in unit tests and app initialization.

Platform-specific places to check:

To disable single project mode, update firebase.json with the singleProjectMode key:

{
  "firestore": {
    ...
  },
  "functions": {
    ...
  },
  "hosting": {
    ...
  },
  "emulators": {
    "singleProjectMode": false,
    "auth": {
      "port": 9099
    },
    "functions": {
      "port": 5001
    },
    ...
  }
}

Which products are paid? Which are no-cost?

For detailed information about paid versus no-cost products, see Firebase pricing plans.

How do I know which pricing plan is right for me?

For detailed information about pricing plans, see Firebase pricing plans.

Spark pricing plan

The no-cost Spark pricing plan is a great place to develop your app at no cost. You get all the no-cost Firebase products (like Analytics, Remote Config, Crashlytics, and so on) and generous amounts of our paid infrastructure features. However, if you exceed your Spark pricing plan resources in a calendar month, your app will be shut off for the remainder of that month. In addition, Google Cloud features are not available when using the Spark pricing plan.

Blaze pricing plan

The pay-as-you-go Blaze pricing plan is designed for production apps. The Blaze pricing plan also lets you extend your app with paid Google Cloud features. You pay only for the resources that you consume, allowing you to scale with demand. We strive to make our Blaze pricing plan prices competitive with industry-leading cloud providers.

Can I upgrade, downgrade, or cancel at any time?

Yes, you can upgrade, downgrade, or cancel at any time. Note that we don't provide prorated refunds for downgrades or cancellations. This means that if you downgrade or cancel before the end of your billing period, you still pay for the remainder of the month.

How is the no-cost usage in the Blaze pricing plan different from the no-cost usage in the Spark pricing plan?

No-cost usage on the Blaze pricing plan is calculated daily. Usage limits also differ from the Spark pricing plan for Cloud Functions, phone authentication, and Test Lab.

For Cloud Functions, no-cost usage on the Blaze pricing plan is calculated at the Cloud Billing account level, not the project level and has the following limits:

• 2M invocations/month
• 400K GB-seconds/month
• 200K CPU-seconds/month
• 5 GB of networking egress/month

For phone authentication, no-cost usage on the Blaze pricing plan is calculated monthly.

For Test Lab, no-cost usage on the Blaze pricing plan has the following limits:

• 30 physical device minutes/day
• 60 virtual device minutes/day

Does the no-cost usage quota reset when I change from the Spark pricing plan to the Blaze pricing plan?

No-cost usage from the Spark pricing plan is included in the Blaze pricing plan. No-cost usage does not reset when moving to the Blaze pricing plan.

What happens to my Firebase project if I link a billing account to that project in the Google Cloud console?

If a Cloud Billing account is linked to a project in the Google Cloud console, the same project will automatically be upgraded to the Firebase pay-as-you-go Blaze pricing plan (if that project was on the no-cost Spark pricing plan).

In contrast, if an existing active Cloud Billing account is unlinked from a project in the Google Cloud console, that project will be downgraded to the Firebase no-cost Spark pricing plan.

How can I monitor my usage and billing?

You can track your usage of project resources in the Firebase console on any of the following dashboards:

• Overall project-level Usage and billing dashboard
• Authentication Usage dashboard (specifically for Phone authentication instances)
• Cloud Firestore Usage dashboard
• Cloud Functions Usage dashboard
• Cloud Storage Usage dashboard
• Hosting Usage dashboard
• Realtime Database Usage dashboard

Can I cap usage on the Blaze pricing plan?

No, you cannot cap your usage on the Blaze pricing plan. However, we are actively evaluating options for supporting caps on usage when on the Blaze pricing plan.

If your project is on the Blaze pricing plan, you can define a budget for your project or account, and receive alerts as spending approaches those limits. Learn how to set up budget alerts.

What kind of support will I receive?

All Firebase apps, including those using no-cost plans, come with email support from Firebase staff during US Pacific business hours. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.

Do you offer open-source, nonprofit, or educational discounts?

The no-cost Spark pricing plan can be used by any type of individual or organization, including nonprofits, schools, and open-source projects. Since these plans already include generous quotas, we don't offer any special discounts or plans for open-source, nonprofit, or educational projects.

Do you offer enterprise contracts, pricing, support, or dedicated infrastructure hosting?

The pay-as-you-go Blaze pricing plan is suitable for enterprises of all sizes, and our SLA meets or exceeds the industry standard for cloud infrastructure. However, we don't offer enterprise contracts, pricing, or support, nor do we offer dedicated infrastructure hosting (that is, on-premises installations) for services like our Realtime Database. However, we're actively investigating options for adding some of these features.

Do you offer ad hoc pricing? I only want pay-as-you-go for one or two features.

We offer ad hoc pricing via the pay-as-you-go Blaze pricing plan, where you pay only for the features that you use.

How do the paid Firebase plans work with Ads? Are there no-cost advertising credits with paid plans?

The Firebase pricing plans are separate from Ads, so there are no advertising credits without cost. As a Firebase developer, you are able to "link" your Ads account to Firebase to support conversion tracking.

All ads campaigns are managed directly in Ads, and Ads billing is managed from the Ads console.

What happened to the Flame pricing plan?

In January 2020, the Flame pricing plan ($25/mo of additional quota) was removed as an option for new sign-ups. Existing plan users were granted a grace period to migrate their projects off the Flame plan. In February 2022, the remaining projects on the Flame pricing plan were downgraded to the no-cost Spark pricing plan.
Accordingly,

• Existing Spark pricing plan and Blaze pricing plan projects and any new projects can no longer switch to or sign up for the Flame plan.
• If you moved an existing Flame plan project to a different pricing plan, the project cannot return to the Flame plan.
• Projects downgraded to the Spark pricing plan can be upgraded to the Blaze pricing plan to resume additional paid services.
• References to the Flame plan have been removed from documentation.

Do you have more questions about the Flame plan retirement? Read some of the additional FAQs below.

Want to learn about the other pricing plans offered by Firebase? Visit our Firebase pricing page. If you'd like to start moving any existing projects to another pricing plan, you can do that in the Firebase console for your project.

Additional FAQs about the Flame plan retirement

Where can I find information about privacy and security in Firebase?

Check out the page Privacy and Security in Firebase.

Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?

Yes. Right now, this is iOS-only, but may change in the future. The Firebase Apple platforms SDK includes the FirebaseCoreDiagnostics framework by default. This framework is used by Firebase to collect SDK usage and diagnostics information to help prioritize future product enhancements. FirebaseCoreDiagnostics is optional, so if you would like to opt out of sending Firebase diagnostic logs, you can do so by unlinking the library from your application. You can browse the full source, including logged values, on GitHub

AdMob: Can I link my Windows apps to Firebase?

No, Windows apps are not supported.

AdMob: Why can't I link my app to AdMob from the Firebase console?

You can link an AdMob app to a Firebase app via the AdMob console. Learn how.

AdMob: What permissions or access do I need to link a Firebase app to an AdMob app?

In order to do this linking, you need the following access:

• AdMob: You need to be an AdMob Admin.
• Firebase: You must have the firebase.links.create permission, which is included in the Owner role and the Firebase Admin role.
• Google Analytics: You must have the Edit role or Manage Users role for the property associated with the Firebase project. Learn more.

AdMob: Can multiple users in the same AdMob account link AdMob apps and Firebase apps?

For multi-user AdMob accounts, the user who created the first Firebase link and accepted the Firebase Terms of Service is the only user who can create new links between AdMob apps and Firebase apps.

AdMob: To use AdMob, which SDKs should I use?

To use AdMob, always use the Google Mobile Ads SDK as described in this FAQ. Additionally and optionally, if you want to collect user metrics for AdMob, then include the Firebase SDK for Google Analytics in your app.

• For iOS projects:
  Import the Google Mobile Ads SDK by following the instructions in the AdMob iOS documentation.
• For Android projects:
  Add the dependency for the Google Mobile Ads SDK to your build.gradle file:
  implementation 'com.google.android.gms:play-services-ads:25.3.0'
  
• For C++ projects and Unity projects: Follow the instructions in the respective documentation.

Analytics: Why is Google Analytics a recommended part of using Firebase products?

Google Analytics is a no-cost and unlimited analytics solution that works with Firebase features to deliver powerful insights. It lets you view event logs in Crashlytics, notification effectiveness in FCM, deep link performance for Dynamic Links, and in-app purchase data from Google Play. It powers advanced audience targeting in Remote Config, Remote Config personalization, and more.

Google Analytics acts as a layer of intelligence in the Firebase console to provide you with more actionable insights about how to develop a high quality app, grow your user base, and earn more money.

To get started, read the documentation.

Analytics: How do I control how my Analytics data is shared with the rest of Firebase?

By default, your Google Analytics data is used to enhance other Firebase and Google features. You can control how your Google Analytics data is shared in your project settings anytime. Learn more about Data sharing settings.

Analytics: How do I update my Analytics property settings?

From the Admin page in your Google Analytics property, you can update your property settings, such as:

• Data sharing settings
• Data retention settings
• Time zone and currency settings

To update your property settings, follow these steps:

1. In the Firebase console, go to your settings > Project settings.
2. Go to the Integrations tab, and then in the Google Analytics card, click Manage or View link.
3. Click the link for your Google Analytics account to open the account and property settings.

Analytics on-device measurement in my iOS app: How was the Analytics SDK updated for on-device conversion measurement support, and am I required to upgrade?

Before our release updating on-device conversion measurement using event data, developers had to manually include multiple SDK modules to use on-device measurement capabilities, a time-consuming process. As a result, we updated the existing default SDK module (FirebaseAnalytics) to include on-device conversion measurement capabilities as well for Google Ads.

If you install the default Google Analytics for Firebase iOS SDK, your app can also benefit from on-device conversion measurement capabilities.

If you've pinned the SDK to a specific version, update to version 11.14.0 or higher and release a new version of your app.

Analytics in my iOS app: Can I install Analytics without ad attribution and IDFA collection features?

Yes. See the Configure Data Collection and Usage page for more details.

Analytics in my iOS app: How do I enable the AdSupport framework?

Some Analytics features, such as audiences and campaign attribution, and some user properties, such as age and interests, require the AdSupport framework to be enabled. Without this framework, Analytics cannot collect information needed for these features to function properly.

To enable the AdSupport framework:

1. In your Xcode project, select your project's target.
2. Select the General tab for your target.
3. Expand the Linked Frameworks and Libraries section.
4. Click + to add a framework.
5. Select AdSupport.framework.
6. Add the -ObjC linker flag to your project's build settings under Other Linker Flags.

Before submitting your app for review, ensure your app complies with IDFA usage guidelines.

Analytics: What changed in the Google Analytics section with the October 2021 update?

You can find a summary of these changes in the Firebase Help Center article New Google Analytics 4 functionality in Google Analytics for Firebase.

Analytics: Why don't I see any Analytics data in the Firebase console after unlinking Firebase from Google Analytics?

Analytics data resides within the Google Analytics property — not within the Firebase project. If you delete or unlink the property, then the Analytics data won't be accessible to Firebase and you'll see an empty Analytics dashboard in the Firebase console. Note that since the data still resides in the previously linked property, you can always relink the property to Firebase and see the Analytics data in the Firebase console.

Linking a brand new Google Analytics account (and thus a new Google Analytics property) to your Firebase project will result in an empty Analytics dashboard in the Firebase console. However, if your previously linked property still exists, then you can move the existing data from the old property to the new property.

Analytics: If my Analytics property and its data were deleted, is there any way to get them back?

No. If your property has been deleted, it isn't possible to undelete the property or retrieve the previously collected Analytics data stored in that property.

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Analytics: If my Analytics property was deleted, can I link a new Google Analytics property to my Firebase project and start using Analytics again?

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Note that since all Analytics data is stored in the property (not the Firebase project), the previously collected Analytics data cannot be retrieved.

Analytics: How will Firebase products or integrated Google products be affected by the deletion of my Analytics property?

Several Firebase products rely on the Google Analytics integration. If your Analytics property and its data are deleted, the following will happen if you use the following products:

• Crashlytics — You can no longer see crash-free users, breadcrumb logs, and/or velocity alerts.
• Cloud Messaging and In-App Messaging — You can no longer use targeting, campaign metrics, audience segmentation, and analytics labels.
• Remote Config — You can no longer use targeted configurations or Personalization.
• A/B Testing — You can no longer use A/B Testing since the experiment measurement is supplied by Google Analytics.
• Dynamic Links — Any feature that relies on data from Google Analytics will be disrupted.

In addition, the following integrations will be affected:

• You can no longer export Analytics data to BigQuery.
• You can no longer take advantage of Google Ads integrations or Google AdMob integrations.

Analytics: Can I move Analytics data from one Firebase project to another project?

No, it isn't possible to directly move Analytics data from one Firebase project to another project. However, you can export and combine data from both projects into a single location, such as BigQuery for analysis.

While moving existing data isn't possible, you can link an existing Analytics property to a new Firebase project and start collecting data from then on in that new project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a property to your Firebase project.

Analytics: How do I segment users who have not met some criterion?

You can reframe the problem by "negatively targeting" these users. For example, reframe the problem as "Don't show ads to people who have bought something", and form an audience of those users to target.

Analytics: Are audiences and/or events defined in the Google Analytics interface also available in the Firebase console?

Your audiences and user properties will be synced. For some features, you'll need to use the Google Analytics interface, such as segmentation and closed funnels. You can access the Google Analytics interface directly via deep-links from the Firebase console.

Any changes you make from the Firebase console can also be performed in Google Analytics, and those changes will be reflected in Firebase.

Authentication: Which regions are supported for phone authentication?

Firebase Authentication supports phone number verification globally, but not all networks reliably deliver verification messages. The following regions have good rates of delivery, and should be expected to work well for phone authentication. Where noted, some carriers are unavailable in a region due to poor delivery success rates.

Authentication: What happened to the no-cost SMS on the Spark pricing plan?

Starting September 2024, to improve the security and service quality of Phone Authentication, Firebase projects must be linked to a Cloud Billing account to enable and use the SMS Service.

Cloud Storage for Firebase: Why do I see an unexpected increase in upload and download operations?

Previously, download and upload requests to the Cloud Storage for Firebase API were not being counted properly. We have taken steps to fix this issue, starting from September 15, 2023.

We recommend monitoring your Usage page for any increases that may count towards your limits.

Cloud Storage for Firebase: How do I predict how much I will be billed for upload and download operations?

Visit the Firebase Pricing page and use the Blaze pricing plan calculator. The calculator lists all the usage types for Cloud Storage for Firebase.

Use the sliders to input the expected usage of your Storage bucket. The calculator will estimate your monthly bill.

Dynamic Links: What are Firebase's future plans for Dynamic Links?

See Dynamic Links FAQ.

Dynamic Links: Why does my Android app access each Dynamic Link twice?

The getInvitation API clears the saved Dynamic Link to prevent it from being accessed twice. Be sure to call this API with the autoLaunchDeepLink parameter set to false in each of the deep link activities to clear it for the case when the activity is triggered outside the main activity.

Realtime Database: What is a "simultaneous database connection"?

A simultaneous connection is equivalent to one mobile device, browser tab, or server app connected to the database. Firebase imposes hard limits on the number of simultaneous connections to your app's database. These limits are in place to protect both Firebase and our users from abuse.

The Spark pricing plan limit is 100 and cannot be raised. The Blaze pricing plan has a limit of 200,000 simultaneous connections per database.

This limit isn't the same as the total number of users of your app, because your users don't all connect at once. If you need more than 200,000 simultaneous connections, review options in Scale with multiple databases.

Realtime Database: What are the scaling limitations of the Realtime Database?

Each Realtime Database instance has limits on the number of write operations per second. For small writes, this limit is approximately 1000 write operations per second. If you are approaching this limit, batching operations using multi-path updates can help you achieve higher throughput.

In addition, each database instance has a cap on the number of simultaneous database connections. Our default limits are large enough for most applications. If you are building an app that requires additional scale, you may need to shard your application across multiple database instances for added scale. You may also consider Cloud Firestore as an alternative database.

Realtime Database: What can I do if I'm over my Realtime Database usage limits?

If you've received an email alert or notification in the Firebase console that you've exceeded your Realtime Database usage limits, you can address it based on the usage limit you've exceeded. To see your Realtime Database usage, go to the Realtime Database Usage dashboard in the Firebase console.

If you're over your download limit, you can upgrade your Firebase pricing plan or wait until your download limit resets at the start of your next billing cycle. To decrease your downloads, try the following steps:

• Add queries to limit the data that your listen operations return.
• Check for unindexed queries.
• Use listeners that only download updates to data — for example, on() instead of once().
• Use security rules to block unauthorized downloads.

If you're over your storage limit, upgrade your pricing plan to avoid service disruptions. To reduce the amount of data in your database, try the following steps:

• Run periodic cleanup jobs.
• Reduce any duplicate data in your database.

Note that it may take some time to see any data deletions reflected in your storage allotment.

If you're over your simultaneous database connections limit, upgrade your plan to avoid any service disruptions. To manage simultaneous connections to your database, try connecting via users via the REST API if they don't require a realtime connection.

Realtime Database: What happens if I exceed the Spark pricing plan storage or download limits for Realtime Database?

To provide you with a predictable price, the resources available to you are capped when your project is on the Spark pricing plan. This means that when you exceed any plan limit in any month, your app will be turned off to prevent any further resource usage and additional charges.

Realtime Database: What happens if I exceed Spark pricing plan simultaneous connection limits for Realtime Database?

When your app reaches its concurrency limit on the Spark pricing plan, any subsequent connections will be rejected until some of the existing connections are closed. The app will continue to work for users who are connected.

Realtime Database: What are automated backups? Do you offer hourly backups for Realtime Database?

Automated backups are an advanced feature for projects that are on the Blaze pricing plan. This feature backs up your Firebase Realtime Database data once a day and uploads it to Google Cloud Storage.

We don't offer hourly backups.

Realtime Database: Why was my Realtime Database reported bandwidth lower than average between September 2016 and March 2017?

For bandwidth calculations, we normally include SSL encryption overhead (based on layer 5 of the OSI model). However, in September 2016, we introduced a bug that caused our bandwidth reporting to ignore encryption overhead. This might have resulted in artificially low reported bandwidth and bills on your account for a few months.

We released a fix for the bug in late March 2017, returning bandwidth reporting and billing to their normal levels.