Error Codes List
Last Updated: 31 May 2024When there is an error sent from the Firebase Server, it can be accessed by using the .errorCode Expression in the Firebase plugin you are using.
Here is a list of such errors that can be used in your C3 project to detect the type of error, and have necessary events accordingly:
Authentication (Most Common)
| Error Code | Description |
|---|---|
"auth/app-deleted" | This instance of FirebaseApp has been deleted. |
"auth/app-not-authorized" | This app, identified by the domain where it's hosted, is not authorized to use Firebase Authentication with the provided API key. Review your key configuration in the Google API console. |
"auth/invalid-api-key" | Your API key is invalid, please check you have copied it correctly. |
"auth/network-request-failed" | A network error (such as timeout, interrupted connection or unreachable host) has occurred. |
"auth/operation-not-allowed" | The given sign-in provider is disabled for this Firebase project. Enable it in the Firebase console, under the sign-in method tab of the Auth section. |
"auth/too-many-requests" | We have blocked all requests from this device due to unusual activity. Try again later. |
"auth/unauthorized-domain" | Thrown if the app domain is not authorized for OAuth operations for your Firebase project. Edit the list of authorized domains from the Firebase console. |
"auth/operation-not-supported-in-this-environment" | This operation is not supported in the environment this application is running on. "location.protocol" must be http, https or chrome-extension and web storage must be enabled. |
"auth/user-token-expired" | Thrown if the user's credential has expired. This could also be thrown if a user has been deleted. Prompting the user to sign in again should resolve this for either case. |
"auth/web-storage-unsupported" | This browser is not supported or 3rd party cookies and data may be disabled. |
"auth/email-already-in-use" | The email address is already in use by another account. |
"auth/invalid-verification-code" | The SMS verification code used to create the phone auth credential is invalid. Please resend the verification code sms and be sure use the verification code provided by the user. |
"auth/invalid-email" | The email address is badly formatted. |
"auth/invalid-phone-number" | The format of the phone number provided is incorrect. Please enter the phone number in a format that can be parsed into E.164 format. E.164 phone numbers are written in the format [+][country code][subscriber number including area code]. |
"auth/wrong-password" | The password is invalid or the user does not have a password. |
"auth/account-exists-with-different-credential" | An account already exists with the same email address but different sign-in credentials. Sign in using a provider associated with this email address. |
"auth/popup-blocked" | Unable to establish a connection with the popup. It may have been blocked by the browser. |
"auth/popup-closed-by-user" | The popup has been closed by the user before finalizing the operation. |
"auth/cancelled-popup-request" | This operation has been cancelled due to another conflicting popup being opened. |
"auth/timeout" | The operation has timed out. |
"auth/user-not-found" | There is no user record corresponding to this identifier. The user may have been deleted. |
"auth/weak-password" | The password must be 6 characters long or more. |
Authentication (Full List)
| Error Code |
|---|
"auth/admin-restricted-operation" |
"auth/argument-error" |
"auth/app-not-authorized" |
"auth/app-not-installed" |
"auth/captcha-check-failed" |
"auth/code-expired" |
"auth/cordova-not-ready" |
"auth/cors-unsupported" |
"auth/credential-already-in-use" |
"auth/custom-token-mismatch" |
"auth/requires-recent-login" |
"auth/dependent-sdk-initialized-before-auth" |
"auth/dynamic-link-not-activated" |
"auth/email-change-needs-verification" |
"auth/email-already-in-use" |
"auth/emulator-config-failed" |
"auth/expired-action-code" |
"auth/cancelled-popup-request" |
"auth/internal-error" |
"auth/invalid-api-key" |
"auth/invalid-app-credential" |
"auth/invalid-app-id" |
"auth/invalid-user-token" |
"auth/invalid-auth-event" |
"auth/invalid-cert-hash" |
"auth/invalid-verification-code" |
"auth/invalid-continue-uri" |
"auth/invalid-cordova-configuration" |
"auth/invalid-custom-token" |
"auth/invalid-dynamic-link-domain" |
"auth/invalid-email" |
"auth/invalid-emulator-scheme" |
"auth/invalid-credential" |
"auth/invalid-credential" |
"auth/invalid-message-payload" |
"auth/invalid-multi-factor-session" |
"auth/invalid-oauth-client-id" |
"auth/invalid-oauth-provider" |
"auth/invalid-action-code" |
"auth/unauthorized-domain" |
"auth/wrong-password" |
"auth/invalid-persistence-type" |
"auth/invalid-phone-number" |
"auth/invalid-provider-id" |
"auth/invalid-recipient-email" |
"auth/invalid-sender" |
"auth/invalid-verification-id" |
"auth/invalid-tenant-id" |
"auth/multi-factor-info-not-found" |
"auth/multi-factor-auth-required" |
"auth/missing-android-pkg-name" |
"auth/missing-app-credential" |
"auth/auth-domain-config-required" |
"auth/missing-verification-code" |
"auth/missing-continue-uri" |
"auth/missing-iframe-start" |
"auth/missing-ios-bundle-id" |
"auth/missing-or-invalid-nonce" |
"auth/missing-multi-factor-info" |
"auth/missing-multi-factor-session" |
"auth/missing-phone-number" |
"auth/missing-verification-id" |
"auth/app-deleted" |
"auth/account-exists-with-different-credential" |
"auth/network-request-failed" |
"auth/null-user" |
"auth/no-auth-event" |
"auth/no-such-provider" |
"auth/operation-not-allowed" |
"auth/operation-not-supported-in-this-environment" |
"auth/popup-blocked" |
"auth/popup-closed-by-user" |
"auth/provider-already-linked" |
"auth/quota-exceeded" |
"auth/redirect-cancelled-by-user" |
"auth/redirect-operation-pending" |
"auth/rejected-credential" |
"auth/second-factor-already-in-use" |
"auth/maximum-second-factor-count-exceeded" |
"auth/tenant-id-mismatch" |
"auth/timeout" |
"auth/user-token-expired" |
"auth/too-many-requests" |
"auth/unauthorized-continue-uri" |
"auth/unsupported-first-factor" |
"auth/unsupported-persistence-type" |
"auth/unsupported-tenant-operation" |
"auth/unverified-email" |
"auth/user-cancelled" |
"auth/user-not-found" |
"auth/user-disabled" |
"auth/user-mismatch" |
"auth/user-signed-out" |
"auth/weak-password" |
"auth/web-storage-unsupported" |
"auth/already-initialized" |
"auth/recaptcha-not-enabled" |
"auth/missing-recaptcha-token" |
"auth/invalid-recaptcha-token" |
"auth/invalid-recaptcha-action" |
"auth/missing-client-type" |
"auth/missing-recaptcha-version" |
"auth/invalid-recaptcha-version" |
"auth/invalid-req-type" |
Realtime-Database
| Error Code | Description |
|---|---|
"TOO_BIG" | The data requested exceeds the maximum size that can be accessed with a single request |
"PERMISSION_DENIED" | Client doesn't have permission to access the desired data |
"UNAVAILABLE" | The service is unavailable |
Cloud Storage
| Error Code | Description |
|---|---|
"storage/unknown" | An unknown error occurred. |
"storage/object-not-found" | No object exists at the desired reference. |
"storage/bucket-not-found" | No bucket is configured for Cloud Storage |
"storage/project-not-found" | No project is configured for Cloud Storage |
"storage/quota-exceeded" | Quota on your Cloud Storage bucket has been exceeded. If you're on the no-cost tier, upgrade to a paid plan. If you're on a paid plan, reach out to Firebase support. |
"storage/unauthenticated" | User is unauthenticated, please authenticate and try again. |
"storage/unauthorized" | User is not authorized to perform the desired action, check your security rules to ensure they are correct. |
"storage/retry-limit-exceeded" | The maximum time limit on an operation (upload, download, delete, etc.) has been excceded. Try uploading again. |
"storage/invalid-checksum" | File on the client does not match the checksum of the file received by the server. Try uploading again. |
"storage/canceled" | User canceled the operation. |
"storage/invalid-event-name" | Invalid event name provided. Must be one of [running, progress, pause] |
"storage/invalid-url" | Invalid URL provided to refFromURL(). Must be of the form: gs://bucket/object |
"storage/invalid-argument" | The argument passed to put() must be File, Blob, or UInt8 Array. The argument passed to putString() must be a raw, Base64, or Base64URL string. |
"storage/no-default-bucket" | No bucket has been set in your config's storageBucket property. |
"storage/cannot-slice-blob" | Commonly occurs when the local file has changed (deleted, saved again, etc.). Try uploading again after verifying that the file hasn't changed. |
"storage/server-file-wrong-size" | File on the client does not match the size of the file received by the server. Try uploading again. |
If you come across any other Error Codes, contact the Developer.
Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.