Why are some images not displaying in my files?

Understanding image display problems

Key points • A missing image often stems from an empty or unlinked field • Conditional visibility can hide certain blocks • An incorrect format, size, or link can prevent loading

When certain images fail to display in your CMS listings, the cause is almost always incomplete settings or an incorrectly filled-out field. Since dynamic pages rely entirely on collections, even the smallest error in a listing can result in a missing visual element on your hotel website. Here are the most frequent causes and how to quickly fix them.

The first step is to verify that the image is correctly added to the corresponding CMS field. If your layout uses a "Main Image", "Banner Image" or "Gallery" field, but this field is empty for the item in question, your listing will display a blank space or automatically hide the area.

Next, ensure your component on the dynamic page is correctly linked to the CMS field. In your CMS template, select the image and verify that it is set to "Get image from CMS". If it is set to a static image, it will not change according to the item, or it will not display the expected image.

💡 Tip: A simple diagnostic tool is to display another item on the same dynamic page. If the image appears for that item, the problem lies with the data. If it doesn't appear for any item, the problem lies with the layout.

Also check conditional visibility. If an image should only be displayed when a specific field is filled (for example, "Secondary Image"), and that field doesn't contain that value, the block may be automatically hidden. Make sure each condition makes sense and that your fields are complete.

Another point to check is the image size, format, or file size. An image that is too large or in an unsupported format may have loading problems. Opt for lightweight formats such as WebP or optimized JPEG, with a maximum width of 1200 pixels for smooth display.

Also, remember to check the gallery fields. If your listing uses multiple images but the gallery requires a minimum number of images to display, deleting an image or leaving a field empty can prevent the gallery from activating.

Finally, if you've just edited or added images, your browser might be displaying a cached version of the page. Try using private browsing or force a refresh (Cmd/Ctrl + Shift + R) to confirm it's not simply a caching issue.

Conclusion

If images are not displaying correctly in your CMS listings, check your fields, dynamic links, conditional visibility settings, file quality, and cache. Once these points are addressed, your visuals will display correctly and enhance the appeal of your hotel website.