This article describes the mechanism of showing images on a Impreza-based site.

Every image uploaded into the Media Library will automatically create several thumbnails with smaller sizes (dimensions in pixels), this is a default WordPress mechanism. The number of such thumbnails depends on the original dimensions of an image and settings. Check the table below.

Predefined Image Sizes #

Dimensions (px) Provided by System name Changeable? Used by default in
1024 x 1024 WordPress large In "Settings > Media" — Post Image of new Grid Layout
— Meta tag "og:image"
300 x 300 WordPress medium In "Settings > Media" — Preloader Screen custom image
150 x 150 (cropped) WordPress thumbnail In "Settings > Media"

— Image Slider "Thumbs" additional navigation
— Sided navigation on Portfolio Pages and Posts
— Map custom marker image
— Product Gallery thumbnails on Product pages
— Product previews in WooCommerce widgets

600 x 600 (cropped) WooCommerce (if installed) shop_single In "Appearance > Customize > WooCommerce > Products Images" — Main Product image on Product pages
300 x 300 (cropped) WooCommerce (if installed) shop_catalog In "Appearance > Customize > WooCommerce > Products Images" — All Product lists (Shop and Category pages, Cross-sell and Up-sell blocks)
  • (cropped) means that the thumbnail will be cropped to the exact width and height ignoring the proportions of an original image
  • if two or more Image Sizes have equal values, then only one thumbnail will be generated

Regarding the table above when you upload a large image (bigger than 1024px), it generates 3 thumbnails (5 thumbnails if you're using WooCommerce) by default. All thumbnails are located in /wp-content/uploads/ folder of your WordPress installation, also thumbnails have a suffix in their file name, which means dimensions in pixels:


Adding new Image Sizes #

To add custom Image Sizes go to Theme Options > Image Sizes:


You can set any amount of additional image sizes. After adding new sizes or changing the existing ones you should regenerate your thumbnails.

We don't recommend setting many Image Sizes because every Image Size:

  • increases uploading time, when you add images to the Media Library
  • creates additional files in your upload directory regarding the number of your uploaded images. For example, if you upload 100 images to your website, you will have 600 files summary by default, and every additional Image Size will add 100 files after regenerating thumbnails.

Regenerating Thumbnails #

Regenerating is available in Impreza by default without additional plugins. When you change image sizes on the Theme Options > Image Sizes, all image thumbnails start to regenerate.

Applying Image Sizes #

In most cases, the theme's elements use the most suitable image sizes, which are predefined by Impreza code, check the "Predefined Image Sizes" table for more information. To improve the website page loading speed management, we implemented the ability to select Image Sizes for the following elements:

  1. Image
  2. Image Slider
  3. Interactive Banner
  4. FlipBox
  5. Popup
  6. Person
  7. Grid
  8. Carousel
  9. Image via the "Add Media" button in the Text editor
  10. Gallery via the "Add Media" button in the Text editor