Custom 404 error images

On this page

When a requested image does not exist in your Sirv account a 404 error - file not found is returned.

No image will be returned but if you visit the image URL directly, you will see an error page - such as this - to help you identify and fix the problem.

Instead of no image being returned, you can show an image of your choice, for example:

Example 404 placeholder image - No Image Available

How to configure a custom 404 placeholder image

  1. Go to the Default profile on your Profiles page and choose "Edit".

    Images in a folder

  2. Click the General Settings link.

    Click to edit General Settings

  3. Enter the file path of your placeholder image. It can be any image in your Sirv account, starting with a forward slash / (denoting the home folder):

    Enter the file path

  4. Save the profile.

  5. Test the new image by visiting any fake image URL.

The image can also be scaled by appending w or h (width / height) parameters to the URL. Example:

https://demofree.sirv.com/nope-not-here.jpg?w=150

Example 404 placeholder - resized error 404 image

Multiple error images

You can also specify error images in any profile of your account, meaning you can display different placeholder images for different parts of your website.

https://demofree.sirv.com/products/123456/123456.jpg?profile=error-example

Example 404 placeholder image - camera icon

Simply go to the "General Settings" section for any profile and enter the path of your chosen image.

Cannot be used with auto fetch

Custom 404 images cannot be used at the same time as Sirv's auto fetch feature. Instead of returning a 404 immediately, auto fetch attempts to download the file from the remote server/bucket that you have configured. Thus, the same 404 response cannot trigger two different behaviours.

Was this article helpful?

Get help from a Sirv expert