Choose a database: Cloud Firestore or Realtime Database

Firebase offers two cloud-based, client-accessible document databases. We recommend new customers start with Cloud Firestore:

  • Cloud Firestore is the recommended enterprise-grade JSON-compatible document database, trusted by more than 250,000 developers. It's suitable for applications with rich data models requiring queryability, scalability, and high availability. It also offers low latency client synchronization and offline data access.

  • Realtime Database is the classic Firebase JSON database. It's suitable for applications with simple data models requiring simple lookups and low-latency synchronization with limited scalability.

What are some other important things to consider?

After thinking about the previous key considerations, you might be ready to choose a database. If you're still weighing advantages and disadvantages, this section covers other differences between Cloud Firestore and Realtime Database.

Data model

Both Realtime Database and Cloud Firestore are NoSQL Databases.

Cloud Firestore Preferred Realtime Database
Stores data as collections of documents.
  • Simple data is easy to store in documents, which are very similar to JSON.
  • Complex, hierarchical data is easier to organize at scale, using subcollections within documents.
  • Requires less denormalization and data flattening.

Learn more about the Cloud Firestore data model.

Stores data as one large JSON tree.
  • Simple data is very easy to store.
  • Complex, hierarchical data is harder to organize at scale.

Learn more about the Realtime Database data model.

Realtime and offline support

Both have mobile-first, realtime SDKs and both support local data storage for offline-ready apps.

Cloud Firestore Preferred Realtime Database
Offline support for Apple, Android, and web clients. Offline support for Apple and Android clients.

Presence

It can be useful to know when a client is online or offline. Firebase Realtime Database can record client connection status and provide updates every time the client's connection state changes.

Cloud Firestore Preferred Realtime Database
Not supported natively. You can build on Realtime Database's support for presence by syncing Cloud Firestore and Realtime Database using Cloud Functions See Build presence in Cloud Firestore. Presence supported.

Querying

Retrieve, sort, and filter data from either database through queries.

Cloud Firestore Preferred Realtime Database
Indexed queries with compound sorting and filtering.
  • You can chain filters and combine filtering and sorting on a property in a single query.
  • Queries are shallow: they only return documents in a particular collection or collection group and don't return subcollection data.
  • Queries must always return whole documents.
  • Queries are indexed by default: Query performance is proportional to the size of your result set, not your dataset.
Deep queries with limited sorting and filtering features.
  • Queries can sort or filter on a property, but not both.
  • Queries are deep by default: they always return the entire subtree.
  • Queries can access data at any granularity, down to individual leaf-node values in the JSON tree.
  • Queries don't require an index; however the performance of certain queries degrades as your dataset grows.

Writes and transactions

Cloud Firestore Preferred Realtime Database
Advanced write and transaction operations.
  • Write data operations through set and update operations as well as advanced transformations such as array and numeric operators.
  • Transactions can atomically read and write data from any part of the database.
Basic write and transaction operations.

Reliability and performance

Cloud Firestore Preferred Realtime Database
Cloud Firestore is a regional and multi-region solution that scales automatically.
  • A low-latency solution, with typical response times no greater than 30 ms.
  • Houses your data across multiple data centers in distinct regions, ensuring global scalability and strong reliability.
  • Available in regional or multi-regional configurations around the world.
Read more about Cloud Firestore performance and reliability characteristics in the Service Level Agreement.
Realtime Database is a regional solution.
  • Available in regional configurations. Databases are limited to zonal availability within a region.
  • Extremely low latency, with typical response times no greater than 10 ms. An ideal option for frequent state-syncing.
Read more about Realtime Database performance and reliability characteristics in the Service Level Agreement.

Uptime

Cloud Firestore Preferred Realtime Database
Extremely high uptime performance.
  • Typical uptime performance of 99.999%.
  • If availability is of the utmost importance, for example in ecommerce apps, use Cloud Firestore.
High uptime performance.
  • Typical uptime performance of 99.95%.

Scalability

Cloud Firestore Preferred Realtime Database
Scaling is automatic.
  • Scales completely automatically. Scaling limits are around 1 million concurrent connections and 10,000 writes/second. We plan to increase these limits in the future.
  • Has limits on write rates to individual documents or indexes.
Scaling requires sharding.
  • Scale to around 200,000 concurrent connections and 1,000 writes/second in a single database. Scaling beyond that requires sharding your data across multiple databases.
  • No local limits on write rates to individual pieces of data.

Security

Cloud Firestore Preferred Realtime Database
Non-cascading rules that combine authorization and validation.
  • Reads and writes from mobile SDKs secured by Cloud Firestore Security Rules.
  • Reads and writes from server SDKs secured by Identity and Access Management (IAM).
  • Rules don't cascade unless you use a wildcard.
  • Rules can constrain queries: If a query's results might contain data the user doesn't have access to, the entire query fails.
Cascading rules language that separates authorization and validation.

Pricing

Both solutions are available on the Spark and Blaze pricing plans.

Cloud Firestore Preferred Realtime Database
Charges primarily on operations performed in your database (read, write, delete) and, at a lower rate, bandwidth and storage.

Cloud Firestore supports daily spending limits for App Engine projects, to make sure you don't go over the costs you're comfortable with.

Read more about Cloud Firestore pricing plans.

Charges only for bandwidth and storage, but at a higher rate.

Read more about Realtime Database pricing plans.

Using Cloud Firestore and Realtime Database

You can use both databases within the same Firebase app or project. Both NoSQL databases can store the same types of data and the client libraries work in a similar manner. Keep in mind the differences outlined previously if you decide to use both databases in your app.

Learn more about the features available in both Realtime Database and Cloud Firestore.

Ready to choose a database?

Hopefully this comparison has helped you settle on a Firebase database solution. Now you can learn how to add a database to your Firebase projects.