Firebase Remote Configplat_iosplat_android

Change the behavior and appearance of your app without publishing an app update.

Firebase Remote Config is a cloud service that lets you change the behavior and appearance of your app without requiring users to download an app update. When using Remote Config, you create in-app default values that control the behavior and appearance of your app. Then, you can later use the Firebase console to override in-app default values for all app users or for segments of your userbase. Your app controls when updates are applied, and it can frequently check for updates and apply them with a negligible impact on performance.

iOS SETUP Android Setup C++ Setup Unity Setup

Key capabilities

Quickly roll out changes to your app's userbase You can make changes to your app's default behavior and appearance by changing service-side parameter values. For example, you could change your app's layout or color theme to support a seasonal promotion, with no need to publish an app update.
Customize your app for segments of your userbase You can use Remote Config to provide variations on your app's user experience to different segments of your userbase by app version, by Firebase Analytics audience, by language, and more.
Run A/B tests to improve your app You can use Remote Config random percentile targeting with Firebase Analytics to A/B test improvements to your app across different segments of your userbase so that you can validate improvements before rolling them out to your entire userbase.

How does it work?

Remote Config includes a client library that handles important tasks like fetching parameter values and caching them, while still giving you control over when new values are activated so that they affect your app's user experience. This lets you safeguard your app experience by controlling the timing of any changes.

The Remote Config client library get methods provide a single access point for parameter values. Your app gets service-side values using the same logic it uses to get in-app default values, so you can add the capabilities of Remote Config to your app without writing a lot of code.

To override in-app default values, you use the Firebase console to create parameters with the same names as the parameters used in your app. For each parameter, you can set a service-side default value to override the in-app default value, and you can also create conditional values to override the in-app default value for app instances that meet certain conditions. This graphic shows how parameter values are prioritized in the service and in your app:

To learn more about parameters, conditions, and how Remote Config resolves conflicts between conditional values, see Remote Config Parameters and Conditions.

Implementation path

Instrument your app with Remote Config Define which aspects of your app's behavior and appearance you want to be able to change using Remote Config, and translate these into the parameters that you will use in your app.
Set default parameter values Set the in-app default values for Remote Config parameters using setDefaults().
Add logic to fetch, activate, and get parameter values Your app can safely and efficiently fetch parameter values from the service and activate those fetched values. So, you can write your app without worrying about the best time to fetch values, or even whether any service-side values exist. Your app uses get methods to get the value of a parameter, similar to reading the value of a local variable defined in your app.
(As needed) Update service-side default and conditional parameter values You can define values in the Firebase console to override in-app default values. You can do this before or after you launch your app, because the same get methods access in-app default values and values fetched from the service.

Policies and limits

Note the following policies:

  • Don't use Remote Config to make app updates that should require a user's authorization. This could cause your app to be perceived as untrustworthy.
  • Don't store confidential data in Remote Config parameter keys or parameter values. It is possible to decode any parameter keys or values stored in the Remote Config settings for your project.
  • Don't attempt to circumvent the requirements of your app's target platform using Remote Config.

Remote Config parameters and conditions are subject to certain limits. To learn more, see Limits on parameters and conditions.

Looking to store other types of data?

  • Firebase Realtime Database stores JSON application data, like game state or chat messages, and synchronizes changes instantly across all connected devices.
  • Firebase Hosting hosts global assets, including the HTML, CSS, and JavaScript for your website as well as other developer-provided assets like graphics, fonts, and icons.
  • Cloud Storage stores files such as images, videos, and audio as well as other user-generated content.

Next steps

Send feedback about...

Need help? Visit our support page.