Introduction

Product images in your dashboard greatly simplify merchandising actions. The goal of this article is to diagnose situations in which some or all images in the dashboard don't show up.

We are also always happy to troubleshoot collaboratively - feel free to reach out to [email protected].

No image uploaded

The dashboard expects an image_url to be upload along with each product. To verify whether your products have images associated with them, go to the interact page and click any product. You should see an image URL in the modal that appears.

If no such URL is present, you'll need to upload images to the image_url. To upload an image_url you can reference the documentation to upload this using the Items endpoint. If you are using a feed-based integration, work with your developers and Constructor support to update the feed definition.

No image domain set

One of the most common issues is that your image URLs are relative and you haven't set an image domain. If this is the case, you should see an image URL after clicking on the modal from the interact page that looks like the URL below:

/assets/images/adorable_dog_costume.jpg

As you can see there is no domain like https://constructor.com in front, just the /assets folder.

Images that fail to load will have an information icon next to them. Clicking the image will provide a prompt to set a base image URL.

You can inspect image links for products on your website with developer tools, or work with your developer to set the correct domain for assets. Once you set this image URL, the images on the page will reload so that you can verify the setting.

The image domain setting will be remembered for each of your search indexes and can be reviewed on your indexes page.

Wrong image URL or domain

If you have set the correct image domain and have an image URL set, it's possible the image URL and/or domain is old, expired or otherwise invalid. To fix this, you can work with your engineering team to update the image_url field definition in your FTP ingestion or API.

Image request restrictions

Occasionally, the image URL and domain are correct, but your website or CDN has restrictions on requests for images from pages outside a specific whitelisted set - so-called "hotlinking."

If there is such a limitation, image URLs & domains requested by the dashboard (visible in developer tools) will look just like on your site but will be blocked with a 403 error.

You'll need to reach out to your engineering team to resolve an image request restriction. Contact [email protected] if you're unclear what to communicate.