firebase

Firebase Error Codes

Error codes returned by Firebase services including Authentication, Firestore, Realtime Database, and Storage. Codes are namespaced by service (e.g. auth/, firestore/).

19 codes

references firebase.google.com/docs/auth/admin/errors firebase.google.com/docs/reference/js/firestore_firebase.google.com/docs/storage/web/handle-errors

· All codes 19 codes

auth-account-exists-with-different-credential Account Exists With Different Credential An account already exists with the same email but was created with a different sign-in provider. Fetch the existing sign-in methods with fetchSignInMethodsForEmail and prompt the user to link accounts or sign in with the original provider.
auth-email-already-in-use Email Already In Use The email address is already associated with an existing account. Sign in with that account, use a different email address, or call fetchSignInMethodsForEmail to determine which sign-in methods are linked to it.
auth-invalid-email Invalid Email The email address is badly formatted. Validate the email format on the client before calling Firebase Auth.
auth-network-request-failed Network Request Failed A network error occurred during authentication. Check the device's internet connection. This can also be caused by browser extensions blocking Firebase requests.
auth-popup-closed-by-user Popup Closed By User The user closed the OAuth sign-in popup before completing authentication. This is a user-initiated cancellation; handle it gracefully without showing an error message.
auth-requires-recent-login Requires Recent Login This security-sensitive operation (e.g. deleting an account, changing email/password) requires the user to have signed in recently. Re-authenticate the user before retrying.
auth-too-many-requests Too Many Requests Access to this account has been temporarily blocked due to many failed login attempts. The user can reset their password to restore access, or wait for the block to lift automatically.
auth-user-not-found User Not Found No user record corresponds to the provided identifier. The user may have been deleted. Avoid revealing this detail in production UIs to prevent user enumeration attacks.
auth-weak-password Weak Password The password does not meet Firebase's minimum strength requirements (at least 6 characters). Enforce a stronger policy on the client side for better security.
auth-wrong-password Wrong Password The password is incorrect. For security, use a generic message like 'Invalid email or password' rather than exposing whether the email or password was wrong.
deadline-exceeded Deadline Exceeded The operation did not complete within the deadline. This typically indicates the server is under heavy load. Retry with exponential backoff.
not-found Not Found The requested Firestore document or resource does not exist. Check for typos in the document path, or verify the document was created before trying to read it.
permission-denied Permission Denied The caller lacks permission to execute the Firestore or Realtime Database operation. Check your security rules to ensure the authenticated user has read/write access to the requested path.
resource-exhausted Resource Exhausted A quota or rate limit has been exceeded. Check the Firebase console for quota usage. Common causes include too many Firestore reads/writes per second or exceeding the free tier limits.
storage-object-not-found Storage Object Not Found No object exists at the desired Firebase Storage reference. Check that the file path is correct and that the file was successfully uploaded before attempting to download or delete it.
storage-quota-exceeded Storage Quota Exceeded The Firebase Storage quota for your project has been exceeded. Upgrade your billing plan or delete unused files to free up space.
storage-unauthorized Storage Unauthorized The user does not have permission to access the Firebase Storage object. Review your Storage security rules to ensure the authenticated user has access to the requested path.
unauthenticated Unauthenticated The request does not have valid authentication credentials. Ensure the user is signed in before making the request, and that the Firebase Auth token has not expired.
unavailable Service Unavailable The Firebase service is currently unavailable. This is typically a transient condition; retry the operation with exponential backoff.