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 theproduct-specific Firebase SDKsto your app, likeAnalytics,Cloud Firestore,Crashlytics, orRemote 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 withGoogle Cloudand 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 offirebase:enabledwithin theLabelspagefor your project in theGoogle Cloudconsole. Learn more about this label in ourFAQ.
What is aGoogle Cloudorganization?
AGoogle Cloudorganization is a container forGoogle Cloudprojects
(including Firebase projects). This hierarchy enables better organization,
access management, and auditing of yourGoogle Cloudand Firebase projects.
For more information, refer toCreating and Managing Organizations.
How do I add Firebase to an existingGoogle Cloudproject?
You may have existingGoogle Cloudprojects managed through theGoogle Cloudconsole or the Google APIs console.
You can add Firebase to these existingGoogle Cloudprojects using any of
the following options:
How does Firebase's integration withGoogle Cloudwork?
Firebase is deeply integrated withGoogle Cloud.
Projects are shared between Firebase andGoogle Cloud, so projects can
have Firebase services andGoogle Cloudservices enabled. You can access
the same project from theFirebaseconsole or theGoogle Cloudconsole.
Specifically:
Certain Firebase products are backed directly byGoogle Cloud, such asCloud Storage for Firebase. The list of products backed byGoogle Cloudwill continue to grow over time.
Many of your settings, including collaborators and billing
information, are shared by Firebase andGoogle Cloud.
Your usage of both Firebase andGoogle Cloudappears on
the same bill.
In addition, when you upgrade to the pay-as-you-go Blaze pricing plan,
you can use any ofGoogle Cloud's world-class
Infrastructure-as-a-Service and APIs directly inside
your Firebase project, at standardGoogle Cloudpricing.
You can
also export data fromGoogle Clouddirectly toBigQueryfor analysis. To learn more, seeLinkBigQuerywith Firebase.
There are many security-enhancing, latency-improving, and time-saving
benefits to usingGoogle Cloudwith Firebase (versus other, cloud
services that are not co-located). Check out theGoogle Cloudsitefor more details.
Why does myGoogle Cloudproject have a label offirebase:enabled?
In theLabelspagefor your project in theGoogle Cloudconsole, you may see a label offirebase:enabled(specifically, aKeyoffirebasewith aValueofenabled).
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 therelationship
between Firebase projects andGoogle Cloud.
We strongly recommend that you don't modify or delete this
label.This label is used by Firebase andGoogle Cloudto list your
Firebase projects (for example, using theREST APIprojects.listendpointor in menus within theFirebaseconsole).
Be aware that manually adding this label to your list of project labels
does NOT enable Firebase-specific configurations and services for yourGoogle Cloudproject. To do that, you need to add Firebase using theFirebaseconsole(or, for advanced use cases, using theFirebase Management REST APIor theFirebaseCLI).
Why is theFirebaseconsole failing to load a list of my existingGoogle Cloudprojects?
This FAQ is most often applicable if you're trying to "add Firebase" to an
existingGoogle Cloudproject using theFirebaseconsoleand you have
access to many thousands ofGoogle Cloudprojects.
In the response from running theFirebaseCLI commandfirebase projects:list
Try these troubleshooting steps:
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
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 theFirebaseconsole via your account avatar in the top-right
corner of the console.
Make sure that your project has the labelfirebase:enabledin theLabelspagefor your project in theGoogle Cloudconsole. Firebase andGoogle Clouduse this label to
list your Firebase projects. If you don't see this label butthe Firebase Management API is enabledfor your project,
then manually add the label (specifically, aKeyoffirebasewith aValueofenabled).
Make sure that you're assigned one of thebasic IAM roles(Owner,
Editor, Viewer) or a role that has Firebase-related permissions in it,
for example aFirebase predefined
role. You can view your role(s) in theIAMpageof theGoogle Cloudconsole.
If your project belongs to aGoogle Cloudorganization, you may
require additional permissions to see the project listed in theFirebaseconsole. Contact the person who manages yourGoogle Cloudorganization 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, contactFirebase 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 aCloud Billingaccount in good standing.
Note the following about the limit on project-creation quota:
This limit isnotspecific to Firebase. Firebase's limits on
project quotaare the same as those forGoogle Cloud.
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 forGoogle 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 ourgeneral 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 theGoogle Cloudconsole tomake your requestand have it evaluated. Learn more aboutquota managementin theGoogle Clouddocumentation.
What happens if I tag my project as a "production" environment?
In theFirebaseconsole, you can tag your Firebase projects with their
environment type, either asProductionorUnspecified(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
coloredProdtag to the project in theFirebaseconsole, 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 tosettingsProject settings>General,
then in theYour projectcard underEnvironment, clickeditto change the environment type.
Where can I find the App ID for my Firebase app?
In theFirebaseconsole, go to yoursettingsProject settings. Scroll down to theYour appscard, then click on the desired Firebase App to view the
app's information, including itsApp ID.
Either of the following Firebase roles: Owner or Firebase Admin
Either of the followingGoogle Playaccess levels: account Owner or
Admin
For linking yourAdMobapp, you need to be both a
Firebase project owner and anAdMobadministrator.
For linking yourAdWords account, you need to be both a
Firebase project owner and an AdWords administrator.
For linking yourBigQueryproject, you need to
be the Firebase project owner.
Permissions and access to Firebase projects
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 permissionresourcemanager.projects.setIamPolicy).
Here are the places where you can assign and manage roles:
TheGoogle Cloudconsole offers an expansive set of tools to assign roles to project members
in theIAMpage. In theCloudconsole, you can also create
and managecustom roles, as well as give service accounts
access to your project.
Note that in theGoogle Cloudconsole, project members are calledprincipals.
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 aGoogle Cloudorganization (see next
paragraph), you cancontact Firebase Supportand check with them about how to request access to the Firebase project.
Note that if a Firebase project is part of aGoogle Cloudorganization, it may not have an Owner.
If you're unable to find an Owner for your Firebase project, contact the person who manages yourGoogle Cloudorganization 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 theFirebaseconsole, you can
view the list of project members, including Owners, in theUsers and permissions pageof theFirebaseconsole.
If you donothave access to the project in theFirebaseconsole, check if you have access to the project in theGoogle Cloudconsole. You can view the list of project members, including
Owners, in theIAMpageof theGoogle Cloudconsole.
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 aGoogle Cloudorganization (see next paragraph), you cancontact
Firebase Supportto have a temporary Owner assigned.
Note that if a Firebase project is part of aGoogle Cloudorganization, it
may not have an Owner. Instead, the person who manages yourGoogle Cloudorganization can perform many tasks that an Owner can do. However, to
perform several Owner-specific tasks (like assigning roles or managingGoogle Analyticsproperties), the administrator may need to assign
themselves theactual Owner roleto perform those tasks. If you're unable to find an Owner for your Firebase
project, contact the person who manages yourGoogle Cloudorganization 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 anOwner.
Project members with the Owner role areoften theonlyproject 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 managingGoogle Analyticsproperties), 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 optionallycustomize 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 aGoogle Cloudorganization, the
person who manages yourGoogle Cloudorganization can perform many tasks
that an Owner can do. However, for several Owner-specific tasks (like
assigning roles or managingGoogle Analyticsproperties), the
administrator may need to assign themselves theactual Owner roleto 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 theFirebaseconsole.
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 theFirebaseconsole via
your account avatar in the top-right corner of the console.
Note that if you're the administrator of aGoogle Cloudorganization, 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 theactual Owner roleto open the
project and perform the required actions. Learn more aboutwhy and when to assign the
Owner role.
Firebaseconsole
What are the supported browsers for accessing theFirebaseconsole?
TheFirebaseconsole 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 theFirebaseconsole, but why can't I find or access my
Firebase project?
This FAQ is applicable if you're experiencing either of the following
issues:
TheFirebaseconsole returns an error page that says your project
may not exist or that you don't have access to the project.
TheFirebaseconsole 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:
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
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 theFirebaseconsole via your account avatar in the top-right
corner of the console.
Make sure that you're assigned one of thebasic IAM roles(Owner,
Editor, Viewer) or a role that has Firebase-related permissions in it,
for example aFirebase predefined
role. You can view your role(s) in theIAMpageof theGoogle Cloudconsole.
If your project belongs to aGoogle Cloudorganization, you may
require additional permissions to see the project listed in theFirebaseconsole. Contact the person who manages yourGoogle Cloudorganization 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, contactFirebase Support.
Why is theFirebaseconsole not loading for me?
This FAQ is applicable if you're experiencing any of the following issues:
A page in theFirebaseconsole never finishes loading.
Data within a page doesn't load as expected.
You receive browser error messages when loading theFirebaseconsole.
TheFirebaseconsole supports the following languages:
English
Brazilian Portuguese
French
German
Indonesian
Japanese
Korean
Russian
Simplified Chinese
Spanish
Traditional Chinese
What roles and permissions does theFirebaseconsole support?
TheFirebaseconsole andGoogle Cloudconsole use the same
underlying roles and permissions. Learn more about roles and permissions in
theFirebase IAM documentation.
A projectOwnercan add other members to the project,
set upintegrations(project linking to services likeBigQueryor Slack), and has
full edit access for the project.
A projectEditorhas full edit access for the project.
A projectViewerhas only read access for the project.
Note that theFirebaseconsole 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.
How does the console's "sample app experience" work? What happens and what can I do?
TheFirebaseconsole provides asample app experienceso that you have a real working app to explore and experiment with Firebase and
other Google services (like theGemini API).
Automatic Firebase setup and deployment of the sample app
When you go through thesample app experiencein theFirebaseconsole, we automatically do the following for you:
Create a new Firebase project for your sample app
Register a Firebase Web App in the new Firebase project
Enable services and APIs that are used by the sample app (for example,Firebase Authentication,Cloud Firestore, etc.)
Provision any required resources (for example, database instances and
security rules)
Set upFirebase AI Logicto use theGemini Developer API
Deploy the sample app to a temporary preview URL usingFirebase Hosting(by default, this URLexpires in 7 days)
Explore the sample app's codebase
Option 1: Open apersonalizedversion of the sample app's codebase inFirebase Studio
The sample app experience provides a pathway to open apersonalizedversion of the sample app's codebase inFirebase Studio(Google's browser-based workspace for full-stack app development). After
your project and app are set up (see above), you can find links toFirebase Studioin banners in theFirebaseconsole and at the top of
the deployed app.
When you open your sample app inFirebase Studio, we automatically do
the following for you:
Use the same Firebase project, Firebase Web App, and resources created
in the initial setup (see above)
Insert your sample app's Firebase configuration into the codebase
(usually intosrc/bootstrap.js)
WithinFirebase Studio, you can explore the codebase to understand how
you can interact with various Firebase and Google services.
Option 2: View thepublic, non-personalizedversion of the sample app's
codebase in GitHub
Alternatively, you can view thepublic, non-personalizedversion of the
sample app's codebase in GitHub.
Why doLocal Emulator Suitelogs show an error starting with
"Multiple projectIds are not recommended in single project mode"?
This message means theLocal Emulator Suitehas 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 theLocal Emulator Suitewill now only allow running with a
single project ID, unless you specify otherwise in thefirebase.jsonconfiguration 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 withfirebase initorfirebase use. To view the list
of projects (and see which one is selected) usefirebase projects:list.
Unit tests.The project ID is often specified in calls
to the Rules Unit Testing library methodsinitializeTestEnvironmentorinitializeTestApp.
Other testing code may initialize withinitializeApp(config).
The command line--projectflag.Passing theFirebaseCLI--projectflag 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:
Web
TheprojectIdproperty in your JavaScriptfirebaseConfigobject, used ininitializeApp.
Does Firebase offer no-cost trial credits for paid products?
Firebase paid services can be used under theGoogle CloudFree Trial.
NewGoogle Cloudand Firebase users can take advantage of a 90-day trial period
that includes $300 in freeCloud Billingcredits to explore and evaluateGoogle Cloudand Firebase products and services.
During theGoogle CloudFree Trial period, you'll be provided a Free TrialCloud Billingaccount. Any Firebase project that's linked to that billing
account will be on thepay-as-you-go Blaze pricing planduring the Free Trial period.
Don't worry,linking a Firebase project to this
Free TrialCloud Billingaccount does not enable us to charge you for usage
beyond these credits. You arenotcharged for usage beyond these credits
unless you explicitly enable billing by upgrading your
Free TrialCloud Billingaccount to a paid account. You can upgrade to a paid
account at any time during the trial. After you've upgraded to a paid account,
you can still use any remaining credits (within the 90-day period).
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 (likeAnalytics,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 Cloudfeatures 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 paidGoogle Cloudfeatures. 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 forCloud Functions, phone authentication, andTest Lab.
ForCloud Functions, no-cost usage on the Blaze pricing plan
is calculated at theCloud Billingaccount 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.
ForTest 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 theGoogle Cloudconsole?
If aCloud Billingaccount is linked to a project in theGoogle Cloudconsole, 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 activeCloud Billingaccount is unlinked from
a project in theGoogle Cloudconsole, 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 theFirebaseconsole on
any of the following dashboards:
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 toset 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 ourSLAmeets 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 ourRealtime 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 withAds? Are there no-cost
advertising credits with paid plans?
The Firebase pricing plans are separate fromAds, so
there are no advertising credits without cost. As a Firebase developer,
you are able to "link" yourAdsaccount to Firebase to
support conversion tracking.
All ads campaigns are managed directly inAds, andAdsbilling is managed from theAdsconsole.
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 theadditional FAQsbelow.
Want to learn about the other pricing plans offered by Firebase? Visit ourFirebase pricing page. If you'd like to start
moving any existing projects to another pricing plan, you can do that in
theFirebaseconsolefor your project.
Additional FAQs about the Flame plan retirement
I have a project or a process or a business model that relies on a fixed
Firebase cost. What should I do?
Sign up for the Blaze pricing plan, and make sure toset budget alerts.
May I be given special access to create new Flame plan projects?
No, Firebase isn't offering special access for projects to switch to or
sign-up for the Flame plan.
I changed my Flame plan project to a different pricing plan. How do I
change it back?
Switching to the Flame plan is no longer possible. For access to services
provided by the Flame plan, make sure that you're using the
Blaze pricing plan, and considersetting
up budget alertsfor your project.
My project was automatically switched to a different pricing plan as part
of the Flame plan retirement. What should I do?
If your project requires additional quota beyond what is provided with the
Spark pricing plan, you'll need to upgrade your project to the
Blaze pricing plan.
Why is the Flame plan being retired?
Over the years, we've seen declining usage of the Flame plan, and most
projects that use the plan are not consuming its full value. Maintaining
this pricing plan is generally not cost-effective, and we feel that we can
serve everyone better if resources went to other Firebase initiatives.
Privacy
Where can I find information about 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 theFirebaseCoreDiagnosticsframework by default. This framework is used by Firebase to collect SDK
usage and diagnostics information to help prioritize future product
enhancements.FirebaseCoreDiagnosticsis 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, onGitHub
A/B Testing
A/B Testing:How many experiments can I create and run?
You are allowed up to 300 experiments per project,
which could consist of up to 24 running experiments, with the rest as draft or completed.
A/B Testing:Why can't I view my experiments after
unlinking and relinking my project to Google Analytics?
Linking to a differentGoogle Analyticsproperty will cause you to lose access to experiments created beforehand. To regain access to a previous experiment, re-link your project to theGoogle Analyticsproperty that was linked when the experiment was created.
A/B Testing:Why do I receive a "Project not linked to
Google Analytics" message when creating aRemote Configexperiment?
If you've alreadylinked Firebase and Google Analytics, but still see a message that Google
Analytics is not linked, make sure that an Analytics stream exists forallapps in your
project. Currently, all apps in a project must be connected to a Google Analytics stream to use
A/B Testing.
You can find the list of all active streams on theGoogle Analytics integration detailspage within the Firebase console, accessed fromsettingsProject Settingschevron_rightIntegrationschevron_rightGoogle Analyticschevron_rightManage.
Creating a Google Analytics stream for any app that does not have one should resolve the issue.
There are a few ways to create streams for missing apps:
If you only have one or two apps missing an associated Google Analytics stream, you can choose
one of the following methods to add a Google Analytics stream:
Delete and re-add any app without an active stream in the Firebase console.
From theGoogle Analytics console, selectAdmin, clickData Streams, then clickAdd stream, add the missing app's details, and clickRegister
app.
If you have more than a few missing app streams, unlinking and relinking your Google Analytics
property is the fastest and most efficient way to create the missing app streams:
Within theGoogle Analyticscard, clickManageto access
Firebase and Google Analytics settings.
Make a note of the Google AnalyticsProperty IDand theLinked Google Analytics account.
Clickmore_vertMoreand selectUnlink Analytics from this project.
Review the warning that appears (don't worry here; you will relink the same property in the
next step), then clickUnlink Google Analytics.
When unlinking is complete, you'll be redirected to theIntegrationspage.
Within theGoogle Analyticscard, clickEnableto begin
the relinking process.
Select your Analytics account from theSelect accountlist.
Next toAutomatically create a new property in this account, clickeditEditand, from theAnalytics propertylist that appears, select your property ID.
A list of all apps in your project appears. Existing stream mappings for each app are
listed, and apps that do not have a stream will have one created for them.
ClickEnable Google Analyticsto relink the property.
To useAdMob, always use theGoogle Mobile AdsSDK as described in
this FAQ. Additionally and optionally, if you want to collect user metrics
forAdMob, then include the Firebase SDK forGoogle Analyticsin your app.
ForAndroid projects: Add the dependency for theGoogle Mobile AdsSDK to yourbuild.gradlefile: implementation 'com.google.android.gms:play-services-ads:25.0.0'
Analytics:Why is Google Analytics a recommended part
of using Firebase products?
Google Analyticsis a no-cost and unlimited analytics solution that
works with Firebase features to deliver powerful insights. It lets you
view event logs inCrashlytics, notification effectiveness inFCM, deep link performance forDynamic Links, and in-app purchase data
fromGoogle Play. It powers advanced audience targeting inRemote Config,Remote Configpersonalization, and more.
Google Analyticsacts as a layer of intelligence in theFirebaseconsole to provide you with more actionable insights about how
to develop a high quality app, grow your user base, and earn more money.
Analytics:How do I control how myAnalyticsdata
is shared with the rest of Firebase?
By default, yourGoogle Analyticsdata is used to enhance other
Firebase and Google features. You can control how yourGoogle Analyticsdata is shared in your project settings anytime.
Learn more aboutData sharing settings.
Analytics:How do I update my Analytics property
settings?
From theAdminpagein 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:
Analyticson-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 forGoogle Ads.
*This configuration will include On-Device Conversion Measurement
(Event Data) as well. If needed, you can disable the feature by setting the
value ofGOOGLE_ADS_ON_DEVICE_CONVERSION_EVENT_DATA_ENABLEDtoNO(Boolean) in your app'sInfo.plistfile.
Analyticsin my iOS app:Can I installAnalyticswithout ad attribution and IDFA collection features?
Analytics:Why don't I see anyAnalyticsdata in
theFirebaseconsole after unlinking Firebase from Google Analytics?
Analyticsdata resides within the Google Analytics property — not
within the Firebase project. If you delete or unlink the property, then theAnalyticsdata won't be accessible to Firebase and you'll see an
emptyAnalyticsdashboard in theFirebaseconsole. Note that
since the data still resides in the previously linked property, you can
always relink the property to Firebase and see theAnalyticsdata in theFirebaseconsole.
Linking a brand new Google Analytics account (and thus a new
Google Analytics property) to your Firebase project will result in an emptyAnalyticsdashboard in theFirebaseconsole. 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 myAnalyticsproperty 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 collectedAnalyticsdata 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 theFirebaseconsole or the Google Analytics UI.
Learn more aboutlinking 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 usingAnalyticsagain?
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 theFirebaseconsole or the Google Analytics UI.
Learn more aboutlinking a Google Analytics property to your
Firebase project.
Note that since allAnalyticsdata is stored in the property (not the
Firebase project), the previously collectedAnalyticsdata 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 MessagingandIn-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 useA/B Testingsince 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:
Analytics: Can I moveAnalyticsdata from one Firebase project to
another project?
No, it isn't possible to directly moveAnalyticsdata from one
Firebase project to another project.
However, you can export and combine data from both projects into a single
location, such asBigQueryfor analysis.
While moving existing data isn't possible, you can link an existingAnalyticsproperty to a new Firebase project and start collecting data
from then on in that new project. You can do this linking in either theFirebaseconsole or the Google Analytics UI. Learn more aboutlinking a property to your Firebase project.
Analytics:How do I segment users who havenotmet 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 anaudienceof those users to target.
Analytics:Are audiences and/or events defined in the
Google Analytics interface also available in theFirebaseconsole?
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 theFirebaseconsole.
Any changes you make from theFirebaseconsole can also be performed in
Google Analytics, and those changes will be reflected in Firebase.
Authentication
Authentication:Which regions are supported for phone
authentication?
Firebase Authenticationsupports 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.
Region
Code
AD
Andorra
AE
United Arab Emirates
AF
Afghanistan
AG
Antigua and Barbuda
AL
Albania
AM
Armenia
AO
Angola
AR
Argentina
AS
American Samoa
AT
Austria
AU
Australia
AW
Aruba
AZ
Azerbaijan
BA
Bosnia and Herzegovina
BB
Barbados
BD
Bangladesh
BE
Belgium
BF
Burkina Faso
BG
Bulgaria
BJ
Benin
BM
Bermuda
BN
Brunei Darussalam
BO
Bolivia
BR
Brazil
BS
Bahamas
BT
Bhutan
BW
Botswana
BY
Belarus
BZ
Belize
CA
Canada
CD
Congo, (Kinshasa)
CF
Central African Republic
CG
Congo (Brazzaville)
CH
Switzerland
CI
Côte d'Ivoire
CK
Cook Islands
CL
Chile
CM
Cameroon
CO
Colombia
CR
Costa Rica
CV
Cape Verde
CW
Curaçao
CY
Cyprus
CZ
Czech Republic
DE
Germany
DJ
Djibouti
DK
Denmark
DM
Dominica
DO
Dominican Republic
DZ
Algeria
EC
Ecuador
EG
Egypt
ES
Spain
ET
Ethiopia
FI
Finland
FJ
Fiji
FK
Falkland Islands (Malvinas)
FM
Micronesia, Federated States of
FO
Faroe Islands
FR
France
GA
Gabon
GB
United Kingdom
GD
Grenada
GE
Georgia
GF
French Guiana
GG
Guernsey
GH
Ghana
GI
Gibraltar
GL
Greenland
GM
Gambia
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Greece
GT
Guatemala
GY
Guyana
HK
Hong Kong, SAR China
HN
Honduras
HR
Croatia
HT
Haiti
HU
Hungary
ID
Indonesia
IE
Ireland
IL
Israel
IM
Isle of Man
IN
India
IQ
Iraq
IT
Italy
JE
Jersey
JM
Jamaica
JO
Jordan
JP
Japan
KE
Kenya
KG
Kyrgyzstan
KH
Cambodia
KM
Comoros
KN
Saint Kitts and Nevis
KR
Korea (South)
KW
Kuwait
KY
Cayman Islands
KZ
Kazakhstan
LA
Lao PDR
LB
Lebanon
LC
Saint Lucia
LI
Liechtenstein
LK
Sri Lanka
LS
Lesotho
LT
Lithuania
LU
Luxembourg
LV
Latvia
LY
Libya
MA
Morocco
MD
Moldova
ME
Montenegro
MF
Saint-Martin (French part)
MG
Madagascar
MK
Macedonia, Republic of
MM
Myanmar
MN
Mongolia
MO
Macao, SAR China
MS
Montserrat
MT
Malta
MU
Mauritius
MW
Malawi
MX
Mexico
MY
Malaysia
MZ
Mozambique
NA
Namibia
NC
New Caledonia
NE
Niger
NF
Norfolk Island
NG
Nigeria
NI
Nicaragua
NL
Netherlands
NO
Norway
NP
Nepal
NZ
New Zealand
OM
Oman
PA
Panama
PE
Peru
PG
Papua New Guinea
PH
Philippines
PK
Pakistan
PL
Poland
PM
Saint Pierre and Miquelon
PR
Puerto Rico
PS
Palestinian Territory
PT
Portugal
PY
Paraguay
QA
Qatar
RE
Réunion
RO
Romania
RS
Serbia
RU
Russian Federation
RW
Rwanda
SA
Saudi Arabia
SC
Seychelles
SE
Sweden
SG
Singapore
SH
Saint Helena
SI
Slovenia
SK
Slovakia
SL
Sierra Leone
SN
Senegal
SR
Suriname
ST
Sao Tome and Principe
SV
El Salvador
SZ
Swaziland
TC
Turks and Caicos Islands
TG
Togo
TH
Thailand
TL
Timor-Leste
TM
Turkmenistan
TO
Tonga
TR
Turkey
TT
Trinidad and Tobago
TW
Taiwan, Republic of China
TZ
Tanzania, United Republic of
UA
Ukraine
UG
Uganda
US
United States of America
UY
Uruguay
UZ
Uzbekistan
VC
Saint Vincent and Grenadines
VE
Venezuela (Bolivarian Republic)
VG
British Virgin Islands
VI
Virgin Islands, US
VN
Viet Nam
WS
Samoa
YE
Yemen
YT
Mayotte
ZA
South Africa
ZM
Zambia
ZW
Zimbabwe
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 aCloud Billingaccount to enable and use the SMS Service.
Authentication:How can I prevent SMS abuse when using
phone authentication?
To help protect your project from SMS traffic pumping and API abuse, take the
following steps:
Look for regions with a very high number of sent SMS and a very low number
(or zero) of verified SMS. The ratio of verified/sent is your success rate.
Healthy success rates are commonly in the 70-85% range since SMS is not a
guaranteed delivery protocol, and some regions may experience abuse. Success
rates lower than 50% imply many sent SMS but few successful logins, which is
a common indicator of bad actors and SMS traffic pumping.
UseSMS Region Policyto either deny SMS regions with low success rates, or only allow certain
regions if your app is only intended for distribution in certain markets.
Limit your authorized authentication domains
Use theAuthentication settings dashboardto manage authorized domains. Thelocalhostdomain is added by default to the
approved authentication domains to simplify development. Consider removinglocalhostfrom the authorized domains in yourproductionproject to
prevent bad actors from running code ontheirlocalhostto access your
production project.
Enable and enforceApp Check
EnableApp Checkto help protect your project from API
abuse by attesting that requests only come from applications associated with
your project.
Remember that you need to enforceApp CheckforAuthenticationin theFirebaseconsole(considermonitoring trafficbefore
enforcing). Also, double check yourreCAPTCHA Enterpriseapproved sites list to validate that it only contains your production sites, and
that the list of applications registered to your project inApp Checkis
accurate.
Note thatApp Checkhelps protect against automated attacks by asserting
that the call comes from one of your registered applications. It does not
prevent users from using your app in unintended ways (for example, starting then
never finishing login flows to generate sent SMS).
Authentication:Are phone numbers ported to a new carrier
supported by phone authentication?
At this time, numbers ported between carriers will result in all SMS becoming
undeliverable for those end users. There is no workaround, and Firebase is
working on this issue.
Authentication:In my Android app, why am I getting the following
error: Google sign in failed?
Follow the troubleshooting steps in this FAQ if you're getting the following
error:
GoogleFragment: Google sign in failed
com.google.android.gms.common.api.ApiException: 13: Unable to get token.
at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)
Make sure thatGooglesign-in is properly enabled as an authentication
provider:
Within theSign in methodtab, disable and then re-enable theGooglesign-in method (even if it's already enabled):
Open theGooglesign-in method, disable it, and then clickSave.
Re-open theGooglesign-in method, enable it, and then clickSave.
Also, in theGooglesign-in provider configuration of theAuthenticationsection, make sure that the OAuth client ID and secret match the web client
displayed in theCredentialspage of theGoogle Cloudconsole (look in theOAuth 2.0 Client IDssection).
Authentication:In my web app, why are sign-in with redirects
failing with the following error: This domainYOUR_REDIRECT_DOMAINis not
authorized to run this operation?
Follow the troubleshooting steps in this FAQ if you're getting the following
error:
This domainYOUR_REDIRECT_DOMAINis not authorized to run this operation.
This error is most likely caused because your redirect domain isn't listed as a
authorized domain forFirebase Authentication, or the API key that you
use with theFirebase AuthenticationService is invalid.
First make sure thatYOUR_REDIRECT_DOMAINis in thelist of authorized domainsfor your Firebase project. If your redirect domain is already listed there,
continue to troubleshoot an invalid API key.
By default,Firebase AuthenticationJS SDK relies on the API key for your Firebase
project that's labeled as theBrowser key, and it uses this key to verify that
a sign-in redirect URL is valid according to the list of authorized domains.Authenticationgets this API key depending on how you access theAuthenticationSDK:
If you useHosting-provided Auth helpersto log users in with theAuthenticationJS SDK, then Firebase automatically
obtains your API key with the rest of your Firebase configuration each time
you deploy toFirebase Hosting. Make sure that theauthDomainin yourweb appfirebaseConfigisproperly configuredto use one of the domains for thatHostingsite. You can verify this by
going tohttps://authDomain__/firebase/init.json,
and checking that theprojectIdmatches that from yourfirebaseConfig.
If youself-host the sign-in code,
then you can use a__/firebase/init.jsonfile to provide the Firebase
configuration to the self-hostedAuthenticationJS SDK Redirect helper. The API
key and theprojectIdlisted in this config file should match yourweb appfirebaseConfig.
Check to make sure this API key hasn't been deleted: Go to theAPIs & Services > Credentialspanel in theGoogle Cloudconsole where all the API keys for your
project are listed.
If theBrowser keyhasnotbeen deleted, check the following:
If you self-host the sign-in code, make sure the API key listed in your__/firebase/init.jsonfile matches the API key in theGoogle Cloudconsole.
Correct the key in the file, if necessary, then redeploy your app.
If theBrowser keyhas been deleted, you can have Firebase generate a
new API key for you: In theFirebaseconsole, go tosettings>Project settings,
then in theYour appssection, click your web app. This action
automatically creates an API key that you can see in theSDK setup and configurationsection for your web app.
Note that in theGoogle Cloudconsole this new API key won't be calledBrowser key; instead, it will be the same name as your Firebase Web App's
nickname. If you decide toadd API restrictionsto this new API key, make sure theFirebase AuthenticationAPI is in the list of
allowed APIs.
Once your new API key is created, complete the applicable steps below:
If you usereservedHostingURLs,
then redeploy your app to Firebase so that it can automatically obtain
the new API key with the rest of your Firebase configuration.
If youself-host the sign-in code,
copy the new API key and add it to your__/firebase/init.jsonfile,
then redeploy your app.
Authentication:How do I manually construct an OAuth web client?
Open theCredentialspage of theGoogle Cloudconsole.
At the top of the page, selectCreate credentials > OAuth client ID.
If you're prompted to configure your consent screen, follow the on-screen
instructions, and then continue with the following steps of this FAQ.
Create the OAuth web client:
For theApplication Type, selectWeb application.
For theAuthorized JavaScript Origins, add the following:
http://localhost
http://localhost:5000
https://PROJECT_ID.firebaseapp.com
https://PROJECT_ID.web.app
For theAuthorized Redirect URIs, add the following:
Within theSign in methodtab, open theGoogle sign-inprovider,
and then paste the web server client ID and secret you just constructed and
copied from theGoogle Cloudconsole. ClickSave.
Authentication:How is%APP_NAME%determined for the
email template for the confirmation email that can be sent to a user when
they sign up using an email address and password?
Before December 2022, the%APP_NAME%in the email template was populated with
the OAuth brand name that was automatically provisioned whenever an Android app
was registered in the Firebase project. Now, since the OAuth brand is
provisioned only when Google sign-in is enabled, the following describes how%APP_NAME%is determined:
If the OAuth brand name is available, then the%APP_NAME%in the email
template will be the OAuth brand name (same as pre-December 2022 behavior).
If the OAuth brand name isnotavailable, here's how the%APP_NAME%in
the email template is determined:
For web apps, the%APP_NAME%will be thedefaultFirebase Hostingsite name(the value preceding.firebaseapp.comand.web.appand usually the
Firebase project ID).
For mobile apps:
If the Android package name or iOS bundle ID is present in the request,
then the%APP_NAME%will be the app name used in the Play Store or
App Store (respectively).
Otherwise, the%APP_NAME%will be thedefaultFirebase Hostingsite name(the value preceding.firebaseapp.comand.web.appand usually the
Firebase project ID).
Note that if the lookup of the defaultFirebase Hostingsite name fails,
then the final fallback is to use the Firebase project ID as the%APP_NAME%.
Cloud Messaging:What's the difference between
the Notifications composer andCloud Messaging?
Firebase Cloud Messaging(FCM) provides a complete set of messaging
capabilities through its client SDKs and HTTP server protocol. For
deployments with more complex messaging requirements,FCMis the
right choice.
The Notifications composer is a lightweight, serverless messaging solution
built onFirebase Cloud Messaging. With a user-friendly graphical console and
reduced coding requirements, the Notifications composer lets you send messages to
re-engage and retain your users, foster app growth, and support marketing
campaigns.
Capabilities
Notifications composer
Cloud Messaging
Target
Single device
Clients subscribed to topics
(for example, weather)
Clients in predefined user segment (app, version, language)
Clients in specified analytics audiences
Clients in device groups
Upstream from client to server
Message Type
Notifications up to 2kb
Data messages up to 4kb
Delivery
Immediate
Future client device local time
Analytics
Built-in Notifications analytics collection and funnel
analytics
Cloud Messaging:Apple announced they're deprecating
the legacy binary protocol for APNs. Do I need to do anything?
No.Firebase Cloud Messagingswitched to the HTTP/2-based APNs protocol in
2017. If you are usingFCMto send notifications to iOS devices,
there should be no action required on your part.
Cloud Messaging:Do I need to use other Firebase
services in order to useFCM?
You can useFirebase Cloud Messagingas a standalone component, in
the same manner as you did with GCM, without using other Firebase
services.
Cloud Messaging:I am an existing
Google Cloud Messaging (GCM) developer. Should I move toFirebase Cloud Messaging?
FCMis the new version of GCM under the Firebase brand.
It inherits GCM's core infrastructure, with new SDKs to makeCloud Messagingdevelopment easier.
Benefits of upgrading toFCMSDK include:
Simpler client development. You no longer have to write your own
registration or subscription retry logic.
An out-of-the-box notification solution. You can use the Notifications composer,
a serverless notifications solution with a web console that lets anyone
send notifications to target specific audiences based on insights from
Google Analytics.
To upgrade from GCM SDKs toFCMSDKs, see the guides for
migratingAndroidandiOSapps.
Cloud Messaging:Why do my targeted devices apparently
fail to receive messages?
When it looks like devices haven't successfully received messages,
check first for these two potential causes:
Foreground message handling for notification messages.
Client apps need to add message handling logic to handle
notification messages when the app is in the foreground on the device.
See the details foriOSandAndroid.
Network firewall restrictions. If your organization has a
firewall that restricts the traffic to or
from the Internet, you need to configure it to allow connectivity withFCMin order for
yourFirebase Cloud Messagingclient apps to receive messages.
The ports to open are:
5228
5229
5230
FCMusually uses 5228, but it sometimes uses 5229 and 5230.FCMdoes not provide specific IPs, so you should allow your
firewall to accept outgoing connections to all IP addresses contained in the
IP blocks listed in Google'sASN of 15169.
Cloud Messaging:I have implementedonMessageReceivedin my Android app, but it is not being
called.
When your app is in the background,notification messagesare displayed in the system tray, andonMessageReceivedis not
called. For notification messages with a data payload, the notification
message is displayed in the system tray, and the data that was included with
the notification message can be retrieved from the intent launched when the
user taps on the notification.
Cloud Messaging:How does an app instance restored
from a backup work withFCM?
OneFCMtoken is connected to an app on one device.FCMdata is excluded from backup, so an app instance restored from a backup is
treated as a new app instance from the perspective ofFCM. Device
users have to open a restored app to be able to get a newFCMtoken.
To avoid conflict with the original app instance, we also recommend
that youexcludeFirebaseinstallation data from backup. TheFirebaseinstallation
data is stored in aPersistedInstallation....jsonfile.
The filename is a constant for an app. For example:<exclude
domain="file"
path="PersistedInstallation.W0R...GQ.json" />
Notifications composer:I am an existing
Google Cloud Messaging (GCM) developer, and I want to use the Notifications composer.
What should I do?
The Notifications composer is an out-of-the-box solution that lets anyone
send notifications to target specific audiences based on insights fromGoogle Analytics. Also, the Notifications composer provides funnel
analysis for every message, allowing easier evaluation of notification
effectiveness.
If you are an existing GCM developer, to use the Notifications composer you have to
upgrade from GCM SDKs toFCMSDKs. See the guides for migratingAndroidandiOSapps.
FCMquotas and limits
How do I notify a large customer base within 2 minutes?
Unfortunately, this use case cannot be supported. You must spread your
traffic out over 5 minutes.
My app notifies users of events,
and these messages must be delivered immediately to support my business
model. Can I get more quota?
Unfortunately, we cannot grant quota increases for this reason. You must
spread your traffic out over 5 minutes.
My messages are about scheduled events. How can I send all my traffic at the
top of the hour?
We recommend that you start sending the notifications at least5 minutesprior to the event.
How long will it take for my quota request to be fulfilled?
This depends a bit on your use ofFCM. In any case, you can expect
an answer in a few business days. In some cases, there may be some
back-and-forth regarding your usage ofFCMand various
circumstances, which can prolong the process. If all requirements are met,
most requests will be handled within 2 weeks.
429s are hard for me / my business
to deal with. Can I get an exemption or more quota to avoid getting 429s?
While we understand that quota limits can be challenging, quotas are vital
to keeping the service reliable and we can't grant exemptions.
Can I get more quota for a temporary event?
You may request additional quota to support an event lasting up to1 month. File the request at least 1 month in advance of the
event and with clear details on when the event starts and ends, andFCMwill make every practical effort to fulfill the request
(no increase can be guaranteed). These quota increases will be reverted
after the end date of the event.
Is my current quota subject to change?
While Google won't do so lightly, quotas may be changed as needed to
protect the integrity of the system. When possible, Google will notify you
in advance of such changes.
Cloud Storage for Firebase
Cloud Storage for Firebase:What are the changes to the
default bucket announced in September 2024?
Cloud Storage for Firebase:Why do I see an unexpected
increase in upload and download operations?
Previously, download and upload requests to theCloud Storage for FirebaseAPI were not being counted properly. We have taken
steps to fix this issue, starting from September 15, 2023.
We recommend monitoring yourUsagepagefor 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 theBlaze pricing plan calculator.
The calculator lists all the usage types forCloud Storage for Firebase.
Use the sliders to input the expected usage of your Storage bucket. The
calculator will estimate your monthly bill.
Cloud Storage for Firebase:Why am I getting service account
permission errors in the console or when using theCloud Storage for FirebaseAPI (like error code 412)?
Here are some likely reasons for getting these errors:
TheCloud Storage for FirebaseAPI is not enabled for your project.
You can check if the API is enabled in theGoogle Cloudconsole. Learn how
to find enabled APIs in your project and how to enable them inthisGoogle Cloudguide.
The required service account forCloud Storage for Firebasehas one of the
following issues:
The service account is missing required permissions.
The service account has been deleted. Note that in theFirebaseconsole,
a missing service account might manifest as a failure to add required IAM
permissions.
For these two service account issues, see the relatedFAQon this page.
Cloud Storage for Firebase:Why do I see new or multiple
service accounts in my Firebase projects that useCloud Storage for Firebase?
Firebase uses service accounts to operate and manage services without sharing
user credentials. When you create a Firebase project, you might notice that a
number of service accounts are already available in your project.
The required service account forCloud Storage for Firebaseis scoped to your
project and is named:service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.
If you usedCloud Storage for Firebasebefore September 19, 2022, you may see an
additional service account on previously-linkedCloud Storagebuckets
named:firebase-storage@system.gserviceaccount.com. This old
service account is no longer supported as of September 19, 2022.
You can view all service accounts for your project in theService accountstabof theFirebaseconsole.
Add the required service account if it's missing
If you deleted the required service account or it's not present in your project,
you can do one of the following to add the service account.
In theFirebaseconsole, a missing service account might manifest as a
failure to add required IAM permissions.
(Recommended)Automated: Use theAddFirebaseREST endpointto re-import your bucket into Firebase. You only need to call this endpoint
once, not once for each linked bucket.
Following that guide, add a service account with the IAM roleCloud Storage for Firebase Service Agentand service account name:service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.
Remove the required service account
We strongly discourage removing the service account because this may block
access to yourCloud Storagebuckets from your apps. To remove the
service account from your project, follow the instructions inDisabling a service account.
Dynamic Links:Why does my Android app access each Dynamic Link
twice?
ThegetInvitationAPI clears the saved Dynamic Link
to prevent it from being accessed twice. Be sure to call this API
with theautoLaunchDeepLinkparameter set tofalsein each of the deep link activities to clear it
for the case when the activity is triggered outside the main
activity.
Performance Monitoring:How many custom URL patterns can I create?
You can create up to 400 total custom URL patterns per app and up to 100 custom URL patterns per
domain for that app.
Performance Monitoring:Why am I not seeing real time display of performance data?
To view real time performance data, make sure that your app uses aPerformance MonitoringSDK version that's compatible with real time data
processing.
iOS— v7.3.0 or later
tvOS— v8.9.0 or later
Android— v19.0.10 or later (orFirebase Android BoMv26.1.0 or later)
Web— v7.14.0 or later
Note that we always recommend using the latest version of SDK, but any
version listed above will enablePerformance Monitoringto process your data in near real
time.
Realtime Database
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 inScale with multiple databases.
Realtime Database:What are the scaling limitations of theRealtime Database?
EachRealtime Databaseinstance 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 updatescan help you achieve higher throughput.
Realtime Database:What can I do if I'm over myRealtime Databaseusage limits?
If you've received an email alert or notification in theFirebaseconsole that you've exceeded yourRealtime Databaseusage limits, you
can address it based on the usage limit you've exceeded. To see yourRealtime Databaseusage, go to theRealtime DatabaseUsagedashboard in theFirebaseconsole.
If you're over your download limit,you can upgrade yourFirebase pricing planor 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 ofonce().
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 forRealtime 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 forRealtime 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 forRealtime Database?
Automated backupsare an advanced
feature for projects that are on the Blaze pricing plan. This
feature backs up yourFirebase Realtime Databasedata once a day and uploads it
toGoogle Cloud Storage.
We don't offer hourly backups.
Realtime Database:Why was myRealtime Databasereported
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, inSeptember 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 lateMarch 2017, returning
bandwidth reporting and billing to their normal levels.
Remote Config
Remote Config:Why don't fetched values change the
behavior and appearance of my app?
Unless you fetch values withfetchAndActivate(),
values are stored locally but not activated. To activate fetched values so
that they can take effect, callactivate. This design lets you
control when the behavior and appearance of your app changes, because you
can choose when to callactivate. After you callactivate, your app source code determines when updated
parameter values are used.
For example, you could fetch values and then activate them the next time a
user starts your app, which removes the need to delay app startup while your
app waits for fetched values from the service. Changes to your app's
behavior and appearance then occur when your app uses the updated parameter
values.
Remote Config:I am making a lot of fetch requests
while developing my app. Why doesn't my app always get the latest values
from the service when it sends fetch requests?
During app development, you might want to fetch and activate configs very
frequently (many times per hour) to let you rapidly iterate as you develop
and test your app. To accommodate rapid iteration on a project with up to 10
developers, you can temporarily set aFirebaseRemoteConfigSettingsobject with a low minimum fetch
interval (setMinimumFetchIntervalInSeconds) in your app.
Remote Config:How quickly does theRemote Configservice return fetched values after my app sends a fetch request?
Devices usually receive fetched values in less than a second, and often
receive fetched values in milliseconds. TheRemote Configservice
handles fetch requests within milliseconds, but the time required to
complete a fetch request will depend on the network speed of the device and
the latency of the network connection used by the device.
If your goal is to make fetched values take effect in your app as
soon as possible, but without creating a jarring user experience,
consider adding calls tofetchAndActivateeach time that
your app does a full screen refresh.
Firebase App Indexingis no longer the recommended way of indexing content
for display as suggested results in Google Search App. This FAQ points to other
useful developer products.
Apple platforms
Universal Linksare the recommended way of linking users directly from search results, websites
and other apps to specific content within your app.
Android
Android App Linksare the recommended way of linking users directly from search results, websites
and other apps to specific content within your app.
You might also be interested in the following options:
App Actions:
Let users launch and control Android apps with their voice, using
Google Assistant.
Android Shortcuts:
Provide users with quick methods to perform an action or access content in
your app.
Firebase User Segmentation Storage
What is Firebase User Segmentation Storage?
Firebase User Segmentation Storage storesFirebaseinstallation IDsand related attributes and segments as well as audience lists you've created
to provide targeting information to other Firebase services that use them,
such asCrashlytics,FCM,Remote Configpersonalization, and more.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-03-02 UTC."],[],[]]
