Simplify Your Web Documentation

When showing images, thumbnails are automatically created from the original image source (when crop pictures is set to 'Yes').
You can find more information in the Image Processing section.

There are a few cases where the original image is used in place of a thumbnail:

• the gd and imagick (when available) PHP image extensions are disabled,
• the image path is remote (starting with http/https) and is a link to a generated image (the image path does not contain an extension),
• the image path is remote (starting with http/https) and the PHP setting allow url fopen is off,
• the image extension is neither jpg, jpeg, png, gif, webp or avif.

Thumbnail creation may fail for other reasons. To understand why it has failed and/or why you are getting original images instead of thumbnails, turn on 'show errors' from the 'advanced' tab.

Creating thumbnails with larger dimensions than the original images will generate images of mediocre quality.

Default image	The image to use when no image has been found Warning new behavior If the article image thumbnail creation fails, the default image is used instead. To see why thumbnails fail to be generated, remove the default image and set Show errors to yes in the advanced tab
New 6.11 Default to category image	Use the image of the category as default whenever possible. If no image is found, the default image will be used instead
Background color	The image's background color for images having transparency
Border width	The border around the images (in pixels)
Border radius	The image border radius
Border color	The border color
Shadow width [CSS3]	A shadow to the image (the bigger the value, the larger the shadow). V-shape shadows require a larger value (around 20). You will need to experiment to find the right value for the image width used
Shadow type [CSS3]	All around   Pro V-shape (better on larger images)   Pro V-shape left (better on larger images)   Pro V-shape right (better on larger images)
Hover effect [CSS3]	Select an effect that will be applied to images whenever images are linked
Create thumbnails	Let the extension process the images or not. If you are not creating thumbnails, the images will be restraint to the head images and width given. No image will be cached. This can be useful in the event you are loading previously optimized images that do not need resizing. Warning when using original images and since images are not cached in that case, avoid looking for images in the text content, which is server intensive.
Mime type	The mime type of the generated thumbnail. When no option is available, the thumbnail is of the same type as the original image
Crop pictures	Crop images to fit the required head width and height while preserving aspect ratio. Otherwise, the thumbnail will fit the width or height.  cropped not cropped maintain height not cropped do not maintain height
Filter	A filter to apply to the thumbnail Sepia Grayscale Sketch Negate Emboss Edge detect New 5.0 apply CSS filters on thumbnails OR original images. With CSS, you are no longer limited to filters applied to thumbnails through the GD library. Reduces server processing!
Quality .jpg	The compression for the .jpg image (0..100). 100 has best picture quality but image file size is the biggest. Usually, a quality of 60 gives good results (enough compression to make the file size small but not too much so that the image still looks good)
Quality .png	The compression for the .png image (0..9). 0 has best picture quality (no compression) but image file size is the biggest. Usually, 3 to 5 give satisfying results
Quality .webp	The compression for the .webp image (0..100). 100 has best picture quality but image file size is the biggest. Usually, a quality of 60 gives good results (enough compression to make the file size small but not too much so that the image still looks good). Note that when an image of WebP type is encountered, a fallback image is also created. WebP support requires PHP 7.1 minimum when using the GD extension
Quality .avif	The compression for the .avif image (0..100). 100 has best picture quality but image file size is the biggest. Note that when an image of Avif type is encountered, a fallback image is also created. Avif support requires PHP 8.1 minimum when using the GD extension
New Original Alt Attribute	By default, the alt attribute of images is the title of the article. You can change this behavior and use the alt attribute of the original image instead. If none found, it falls back to the default
Allow remote access	Gives access to remote image files (only valid when allow_url_fopen is enabled) when creating thumbnails.
Free 7.0 Pro High resolution	Create additional thumbnails ready for devices with higher pixel ratios (like Retina screens) Warning If you are not creating thumbnails through the extension, you need to provide high resolution images manually. High resolution images are twice the size of the original and their file name ends with @2x. For instance, image.jpg of size 100x200 must have a high resolution counterpart image @2x.jpg of size 200x400
Free 5.2 Pro Lazy load	Defers the loading of images until needed. New 5.0 The standard loading attribute is used. Warning It may interfere with animations (it will interfere with the pure javascript scroll). If items do not show, turn off lazy loading.
Removed in 5.0 Now in Config Pro Loader type	The loader used for lazy load Default use the animated gif loader Data URI add specific encoded image directly embedded into the source code Image select your own image, animated or not
Removed in 5.0 Now in Config Pro Data URI	The encoded image data that will be used as loader. The format is: data:[mime type];charset=[charset];base64,[encoded data]
Removed in 5.0 Now in Config Pro Image	The image (animated or not) that will be used as loader
Free 5.2 Pro Image tag attributes	Attributes that can be added to the <img> tag Example data-pin-nopin="true" will prevent images to be pinned for Pinterest

An image PHP extension is required for the creation of image thumbnails. The GD PHP extension is used by default. Make sure this extension is available on your service provider's server. The module will detect this automatically.

Joomla 4 The extension supports the Imagick PHP image extension. If Imagick is available on your server, you may use it instead of the GD extension. To do so, go to the SimplifyYourWeb extensions System plugin and select the preferred library.