Error Codes
When developing your application with Vercel, you may encounter a variety of errors. They can reflect issues that happen with external providers such as domain services or internal problems at the level of your application's deployment or your usage of platform features.
For general error handling guidance, that covers dashboard related errors, see General Errors.
BODY_NOT_A_STRING_FROM_FUNCTION
Function502DEPLOYMENT_BLOCKED
Deployment403DEPLOYMENT_DELETED
Deployment410DEPLOYMENT_DISABLED
Deployment402DEPLOYMENT_NOT_FOUND
Deployment404DEPLOYMENT_NOT_READY_REDIRECTING
Deployment303DEPLOYMENT_PAUSED
Deployment503DNS_HOSTNAME_EMPTY
DNS502DNS_HOSTNAME_NOT_FOUND
DNS502DNS_HOSTNAME_RESOLVE_FAILED
DNS502DNS_HOSTNAME_RESOLVED_PRIVATE
DNS404DNS_HOSTNAME_SERVER_ERROR
DNS502EDGE_FUNCTION_INVOCATION_FAILED
Function500EDGE_FUNCTION_INVOCATION_TIMEOUT
Function504FALLBACK_BODY_TOO_LARGE
Cache502FUNCTION_INVOCATION_FAILED
Function500FUNCTION_INVOCATION_TIMEOUT
Function504FUNCTION_PAYLOAD_TOO_LARGE
Function413FUNCTION_RESPONSE_PAYLOAD_TOO_LARGE
Function500FUNCTION_THROTTLED
Function503INFINITE_LOOP_DETECTED
Runtime508INVALID_IMAGE_OPTIMIZE_REQUEST
Image400INVALID_REQUEST_METHOD
Request405MALFORMED_REQUEST_HEADER
Request400MICROFRONTENDS_MIDDLEWARE_ERROR
Function500MIDDLEWARE_INVOCATION_FAILED
Function500MIDDLEWARE_INVOCATION_TIMEOUT
Function504MIDDLEWARE_RUNTIME_DEPRECATED
Runtime503NO_RESPONSE_FROM_FUNCTION
Function502NOT_FOUND
Deployment404OPTIMIZED_EXTERNAL_IMAGE_REQUEST_FAILED
Image502OPTIMIZED_EXTERNAL_IMAGE_REQUEST_INVALID
Image502OPTIMIZED_EXTERNAL_IMAGE_REQUEST_UNAUTHORIZED
Image502OPTIMIZED_EXTERNAL_IMAGE_TOO_MANY_REDIRECTS
Image502RANGE_END_NOT_VALID
Request416RANGE_GROUP_NOT_VALID
Request416RANGE_MISSING_UNIT
Request416RANGE_START_NOT_VALID
Request416RANGE_UNIT_NOT_SUPPORTED
Request416REQUEST_HEADER_TOO_LARGE
Request431RESOURCE_NOT_FOUND
Request404ROUTER_CANNOT_MATCH
Routing502ROUTER_EXTERNAL_TARGET_CONNECTION_ERROR
Routing502ROUTER_EXTERNAL_TARGET_ERROR
Routing502ROUTER_EXTERNAL_TARGET_HANDSHAKE_ERROR
Routing502ROUTER_TOO_MANY_HAS_SELECTIONS
Routing502TOO_MANY_FILESYSTEM_CHECKS
Routing502TOO_MANY_FORKS
Routing502TOO_MANY_RANGES
Request416URL_TOO_LONG
Request414
The following errors are related to the Vercel platform. If you encounter one of these errors, contact Vercel support.
FUNCTION_THROTTLED
Internal500INTERNAL_CACHE_ERROR
Internal500INTERNAL_CACHE_KEY_TOO_LONG
Internal500INTERNAL_CACHE_LOCK_FULL
Internal500INTERNAL_CACHE_LOCK_TIMEOUT
Internal500INTERNAL_DEPLOYMENT_FETCH_FAILED
Internal500INTERNAL_EDGE_FUNCTION_INVOCATION_FAILED
Internal500INTERNAL_EDGE_FUNCTION_INVOCATION_TIMEOUT
Internal500INTERNAL_FUNCTION_INVOCATION_FAILED
Internal500INTERNAL_FUNCTION_INVOCATION_TIMEOUT
Internal500INTERNAL_FUNCTION_NOT_FOUND
Internal500INTERNAL_FUNCTION_NOT_READY
Internal500INTERNAL_FUNCTION_SERVICE_UNAVAILABLE
Internal500INTERNAL_MICROFRONTENDS_BUILD_ERROR
Internal500INTERNAL_MICROFRONTENDS_INVALID_CONFIGURATION_ERROR
Internal500INTERNAL_MICROFRONTENDS_UNEXPECTED_ERROR
Internal500INTERNAL_MISSING_RESPONSE_FROM_CACHE
Internal500INTERNAL_OPTIMIZED_IMAGE_REQUEST_FAILED
Internal500INTERNAL_ROUTER_CANNOT_PARSE_PATH
Internal500INTERNAL_STATIC_REQUEST_FAILED
Internal500INTERNAL_UNARCHIVE_FAILED
Internal500INTERNAL_UNEXPECTED_ERROR
Internal500
Last updated on March 12, 2025
Was this helpful?