Articles in this section

See more

HTTP Status codes

2023-08-08 09:53:51 UTC

Overview

If you receive an error code for an image request, you can find the meaning and possible causes below.

List of errors

400 Bad Request

  • The image is requested from a Web Proxy Source, and the URL that is proxied is not an absolute URL.
  • The image is requested from a Web Proxy Source with an invalid hostname.
  • There is a default parameter on your Source causing an issue
    • Having a mark or blend referencing an image in the same Source will cause a loop due to how the mark works. If you are using a mark or blend, make sure it's referencing an image in a different Source
  • Using a base64 parameter without base64 encoding will return a 400 response

403 Forbidden

  • The image is requested from a Source with the Secure URL option turned on, but the s signature is either missing or invalid.
  • The Source is configured to know the presence of the object, but the object is missing.
  • Any permissions that the Source needs to access images from the origin are incorrect.

404 Not Found

  • The image cannot be accessed from the origin. Please check that:
    • The file path to the image is correct in your imgix source settings
    • If you're using an S3 source, check that the the S3 Access Key and Access Key ID credentials entered in imgix are valid, and that IAM user has sufficient permissions to access the object
    • The image can be accessed by imgix and is not being blocklisted
    • The HTTPS certificates on the origin are valid and working

410 Gone

  • The image is requested from a Source that is not deployed.
    • Check to see that the Source is actually deployed
  • The image is requested from a Source that does not contain the hostname of the URL under Domains.

413 Request Entity Too Large

  • The requested image is too large. Our current input limit is 500MB.

414 URI Too Long

  • The URI is too long. The current limit is 3072 characters. If you require a higher limit, please contact Support
    • Due to certain browser limitations, we recommend using a maximum of 2048 characters.

421 Misdirected Request

  • The requested image has failed internal verification. This is usually caused by a corrupt image.

422 Precondition failed

  • A parameter in the query string contains an invalid value, e.g. w=0.
  • The image (or watermark/blend) is not able to be processed
    • This can be due to the filetype or to file corruption. You can verify this saving the image locally and by installing imagemagick's command-line tool. Once installed, you can run magick identify -verbose image_name.png in your command line to diagnose the issue.
  • You are using an SVG in the mark/blend URL in a Source where SVG rendering is not enabled
  • A color profile may be missing from the image (check the image metadata)
  • The GIF you're processing is too large either in frame count or individual frame size

500 Internal Server Error

  • An error occurred while processing the image.

503 Service Unavailable

  • Temporary unavailability due to processing requirements, i.e. a requested GIF is too large.

504 Gateway Timeout

  • A timeout occurred while attempting to fetch the object from the origin.

More troubleshooting info

400 errors

Improper base64url encoding

If the URL contains a base64 encoded value, check to see that it's using proper base64 URL and filename safe variant (RFC_4648).

Base64url encoding replaces certain "unsafe" or reserved characters in a URL with a URL safe equivalent. The substitutions that should take place after the URL is base64 encoded:

  • / is replaced by _
  • + is replaced by -
  • All = characters are removed

If you're seeing URL non-safe characters in the URL, making the substitions above will correct the issue.

410 errors

Source is not yet deployed

Most of the time, this issue means that your Source is not yet deployed.

You can either wait until the Source is fully deployed (10-15 minutes) or check to ensure that you're using the right Source URL.

503 errors

SSL related issue

A 503 error most commonly indicates an SSL error.

To check if this is the issue, use this tool to diagnose your SSL certificate:
https://www.sslshopper.com/ssl-checker.html

It should be showing all green and should not have any warnings. If you find any warnings, fixing them will resolve the 503 error.

512 errors

Origin image limit exceeded

A 512 error code is returned when a user exceeds their monthly allotment of Origin Images.

To fix this error, you can either:

  • Upgrade your plan to continue serving new images
  • Wait until next month for the counter to reset

You can read more about usage limits and pricing on or pricing page.

Incapsula CDN

If you're using Incapsula as a CDN and you're experiencing a 503 error when serving your images, this is most likely due to an invalid cookie header being sent to our servers.

Incapsula deliberately does this as a way to determine if the requester is a bot or a human, but unfortunately our software requires that all headers contain only valid characters.

To fix this, you can ask them to disable this feature for your account or you can change your set up so that imgix bypasses your CDN directly.

content-length: 0

It's possible for an image to be cached with content-length: 0 and still return a 200 response code. Most likely, this is due to the image having been cached previously with content-length: 0 upon a first time request. 

To resolve this, you can issue a purge request for the image URL. This will purge all variations of this image and serve the image with the correct content-length value.

Related articles