Image Settings

Image dimensions for each Shopp image used in the storefront website are defined in the layout instructions found in the Shopp template files. The templates can have hard coded image size instructions, or use a named image setting. When a template uses a named setting, you can adjust the settings using the Image settings screen found in the WordPress admin under the Shopp menus: ShoppSetupImages.

Image Settings

Creating new image settings will require technical implementation in the Shopp template files. If you’re not familiar with the process, it is usually best left to a developer.If your templates were created for you by a developer, you will mostly edit existing settings.

To edit an image setting:
  • Click the name of the image setting or the Edit link below the name.

You can adjust the following image properties using Shopp’s image settings manager: dimensions (width and height), fit, quality, and sharpness.


For dimensions larger than the original image, Shopp will place the full-size image into the new image dimensions without resizing. Shopp cannot upscale images to larger sizes.

The dimensions specify the width and height of the image in pixels. The resized image will always fit within these dimensions though, depending on the Fit setting you select, the final dimensions may be smaller. If the dimensions of the image size are larger than the original full-size image uploaded, the full-size image will be placed directly into the image without resizing it.


The Shopp Image Server can resize images using a number of different fit techniques. Each fit setting has slightly different results so you may need to experiment to get just the right look.

  • all
    Scale the image down to fit all dimensions within the new size (the final size may differ from the specified width and height settings).
  • fill
    Scale the image down to fit within the new size filling extra space to match the exact width and height settings with a background color.
  • crop
    Scale the image down to fit the width and height settings by using the smallest dimension to fill the entire image, cropping the extra off the other dimension. Specific cropping adjustments can be made to the image from the image detail editor in the product editor.
  • width
    Scale the image down to fit the image in the new size by the width, cropping off any extra height.
  • height
    Scale the image down to fit the image in the new size by the height, cropping any extra width off.
Setting NameValue
Highest quality, largest file size100%
Higher quality, larger file size92%
Balanced quality & file size80%
Lower quality, smaller file size70%
Lowest quality, smallest file size60%


Shopp resized images are generated as JPG or PNG images. When generating JPG format images, the quality setting will set the JPG quality. Shopp settings are skewed toward higher quality settings to preserve the quality presentation of the image at the most balanced representation. The available quality settings map to the quality percentage values shown in the table above.


The sharpness value applies a professional-grade unsharp mask filter to increase the sharpness of images as they are reduced. Typically when reducing the size of an image, the details of the image blur together as the pixels combine at smaller scale. Using the unsharp mask is a proven way to restore crisp details in an image. You can set the sharpness of the image at a range of anywhere between 100%-500%. Anything setting less than 100% is ignored.

  1. On my client’s site she is selling paintings and reproductions of the paintings. She has had many people steal the images off of her site and create postcards with them. Is there any way to group watermark the larger images, or all of them, without having to go thru and manually do each image individually in a photo editing program and re-upload them?

    April 24th   #

  2. You should take a look at the Shopp Watermark plugin:

    September 5th   #

You must be logged in to post a comment.

© Ingenesis Limited. Shopp™ is a registered trademark of Ingenesis Limited.