Working with Additional Images

Having multiple images for a product

How do I enable the additional images feature?

Go to Admin > Catalog > Product Types, then selecting Product - General (or whatever your product type is), then clicking Layout Settings, and setting Show Product Additional Images to 1.

Then add additional images for your products, following the naming conventions set out in Image Filename conventions.

Additional images filename matching rules

Using an underscore and more characters after the base filename is the best practice for ensuring your additional images work as expected. See Image Filename Conventions for details.

Prior to Zen Cart 2.1.0, image matching did not enforce the check of a _ suffix when looking for additional product images in the “images/” directory (but it DID require the _ in any images/whatever/ subdirectories). Starting with Zen Cart v2.1.0 a stricter matching pattern requires the _ in both locations, by default, but can be overridden.

Stores that are upgrading from pre-2.1.0 will automatically retain the old functionality by default, but can switch over to strict mode by changing the Admin > Images >Additional Image matching pattern setting from legacy to strict.

How do I disable the additional images feature?

Go to Admin > Catalog > Product Types, then selecting Product - General (or whatever your product type is), then clicking Layout Settings and setting Show Product Additional Images to 0.

Why do I see images for other products on my product pages?

The additional images feature is causing this because of misconfigured image filenames.

You have two options:

a) rename your images so they don’t share a common filename.  Right now since you have one product with “abc.jpg” as the name, and another product with “abcde.jpg” as the name, both images will show for the “abc.jpg” product, because “abc” is common to both, and “abc” is the full filename of the main image of one of the products. 

This is explained further in Image Filename Conventions.

b) or turn off all extra-image functionality by following the directions above to disable additional images.

Is there an easier way to manage multiple product images?

The popular plugin Image Handler allows you to manage multiple product images.

To add images to a product using Image Handler,

  • Go to Tools > Image Handler
  • On the Image Manger tab, drill down to the category and then the product
  • Click the button “Click to add a new image to this product.”

Note that the product must be enabled for you to do this.

How will additional images appear?

Additional images are shown below the main product image, and can be clicked on the same way the main image can - see Popups.

This product has one additional image.

Single Additional Image

This product has multiple additional images.

Multiple Additional Images




Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified May 29, 2024 by Scott Wilson (379cf8c).