Firestore: DEADLINE_EXCEEDED / UNAVAILABLE Google Cloud / Firebase Origin: Platform & cloud OSI layer 7 · Application Last updated 4 Nov 2026

Firestore: 4 DEADLINE_EXCEEDED: Deadline exceeded / 14 UNAVAILABLE: The service is currently unavailable

A Firestore request timed out or could not reach the service — contention, hot documents, large operations or network issues.

Exact message you may see 4 DEADLINE_EXCEEDED: Deadline exceeded14 UNAVAILABLE: The service is currently unavailableFirestore DEADLINE_EXCEEDED10 ABORTED: Too much contention on these documentsCould not reach Cloud Firestore backend. Backend didn't respond within 10 seconds
Explore the map of this error Full error map →
Seen on: Google Cloud JavaScript

Meaning

Retry with exponential backoff (client SDKs do for some calls). Reduce write contention (one document updated more than ~1/second sustained), batch large writes in chunks of 500, avoid unbounded queries, and check connectivity (offline persistence on mobile). ABORTED indicates transaction contention.

Common causes

  • Hot document updated too often (1 write/sec guideline)
  • Large batch/transaction or large queries
  • Network blocked/unstable
  • Cloud Functions timeouts hitting Firestore
  • Service transient issue

⚡ Quick fix

  1. Retry with backoff and jitter
  2. Shard counters; spread writes across documents
  3. Paginate queries and chunk batches

Detailed fix by platform

Firebase

  1. Use limit() and cursors; for counters use distributed counters or FieldValue.increment across shards

How to diagnose

  1. Code — DEADLINE_EXCEEDED, UNAVAILABLE, ABORTED?
  2. Hotspot — Single doc?
  3. Size — Batch/query large?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Platform & cloud. Errors that are often confused with or caused by this one (click to open):

auth/network-request-failed — Firebase Auth: auth/network-request-failed — A network AuthError (such as timeout, interrupted connection or unreachable host) has occurred (Authentication)auth/network-request-…Error 403: API has not been used in project (Terraform) — Terraform: Error: Error creating Network: googleapi: Error 403: Compute Engine API has not been used in project 123 before or it is disabled (Terraform)Error 403: API has no…Firebase CLI: Authentication Error: Your credentials are no longer valid — Firebase CLI: Error: Authentication Error: Your credentials are no longer valid. Please run firebase login --reauth (Google Cloud / Firebase)Firebase CLI: Authent…Firebase Hosting: Page Not Found on refresh (SPA routes) — Firebase Hosting: Page Not Found — This file does not exist and there was no 404.html or index.html found in the document root (Google Cloud / Firebase)Firebase Hosting: Pag…Firebase: Your project must be on the Blaze (pay-as-you-go) plan — Firebase CLI: Error: Your project my-app must be on the Blaze (pay-as-you-go) plan to complete this command. Required API cloudbuild.googleapis.com can't be enabled until the upgrade is complete (Google Cloud / Firebase)Firebase: Your projec…Firestore: Document exceeds the maximum size of 1,048,576 bytes — Firestore: 3 INVALID_ARGUMENT: The value of property "data" is longer than 1048487 bytes / Document exceeds the maximum size (Google Cloud / Firebase)Firestore: Document e…Firestore: The query requires an index — Firestore: 9 FAILED_PRECONDITION: The query requires an index. You can create it here: https://console.firebase.google.com/... (Google Cloud / Firebase)Firestore: The query …Google provider: could not find default credentials — Terraform: Error: Attempted to load application default credentials since neither `credentials` nor `access_token` was set in the provider block. No credentials loaded (Terraform)Google provider: coul…Firestore…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.