Convert on Upload
Use this tab if you want a WebP (and AVIF, if you chose that format) copy as soon as you upload a photo. Open System > Plugins > System - WebP Converter, then click the Convert on Upload tab. Click Save after you change anything.
Turn it on
- Set Convert on upload to Yes. It is off by default.
- Leave the source switches on unless you want to skip one of them:
- Joomla Media Manager — uploads and overwrites in the core Media Manager
- JCE File Manager — uploads in JCE's file or image browser
- SP Page Builder Media Manager — uploads in SP Page Builder, including the
_spmedia_thumbsthumbnail copies made in the same upload
- Click Save.
Your original photo stays on the server. The converted copy is stored under the output folder from General Settings (default images/webp/), just like copies made when a page is viewed or when you click Generate Images. Quality, format, and Exclusion Settings also apply here.
If you chose AVIF (or Both) and the server cannot create an AVIF file, the plugin writes a WebP copy instead and records a note in the Joomla log.
A large photo can take a moment longer to finish uploading, because the converted copy is made in the same step.
After an upload, the webp folder may not show in the Joomla Media Manager or in SP Page Builder until you refresh the file list. In JCE File Manager it usually appears at once.
Size limits
The Size limits note on this tab introduces two optional fields: Maximum width (px) and Maximum height (px). Leave a field at 0 (the default) for no limit on that side. You can set one or both.
Large photos are scaled down to fit, keeping their proportions. Smaller images are never enlarged. By default, only the WebP or AVIF copy is resized. The original file is not changed unless you also turn on the option below.
These limits apply only to uploads and to the scheduled task:
- Uploads through the Joomla Media Manager, JCE, and SP Page Builder (Convert on upload must be on)
- The WebP Converter: convert missing or stale images scheduled task
You can set the limits even if Convert on upload is off; the scheduled task will still use them. The limits do not apply to copies made when someone views a page, or when you click Generate Images — those copies stay at full size. If a limit is set, the scheduled task later resizes those full-size copies in the background.
If you change a limit, the scheduled task regenerates only copies that are still larger than the new limit. Page views and Generate Images do not rebuild them. If you turn both limits back to 0, nothing is regenerated, and already-resized copies stay as they are.
Animated GIFs are not resized. If a very large photo does not have enough memory to resize, the plugin writes a full-size copy and notes this in the Joomla log.
Also downscale the original (modifies your file)
Also downscale the original (modifies your file) is off by default (No). Turn it on only if you also want the uploaded original to be resized to the same Maximum width and Maximum height. Convert on upload and at least one size limit must be set.
- It applies only to brand-new files. If you replace or edit an existing image in the Joomla Media Manager, or overwrite a file in JCE or SP Page Builder, that original stays at its current size even when this option is on. The WebP or AVIF copy is still updated and size-limited as usual.
- The scheduled task never changes originals.
- Excluded images and GIFs are not changed.
- The file keeps the same name and type (for example a JPG stays a JPG) and is saved upright.
- The original is replaced only if the new file is smaller.
- Camera data (EXIF and ICC) is removed from the re-saved file.
- SP Page Builder makes its thumbnail from the full-size file before the original is downscaled.
This permanently changes the original. Keep a backup of important photos before you turn this on.
Phone photos and orientation
Portrait photos from a phone often store a rotation flag instead of saving the pixels upright. The plugin applies that rotation whenever it makes a WebP or AVIF copy (on upload, a page view, Generate Images, and the scheduled task), so the picture appears the right way up on the site.
An original that already fits the size limits is left as it is, even if it still has a rotation tag. Older sideways copies are not changed on a page view. To fix them, set a size limit and let the scheduled task run, or use Delete Converted Images and then Generate Images on the Image Management tab.
Animated GIFs
Animated GIFs are skipped on upload and by the scheduled task, so the moving file is left alone. When a public page first loads that GIF, the plugin can still make a still (first-frame) WebP, which is the same as before.
Files added by FTP or other tools
Convert on upload only watches the Media Manager, JCE, and SP Page Builder. For files copied in by FTP, a backup restore, or another tool, add a scheduled task:
- Open System > Scheduled Tasks.
- Click New and choose WebP Converter: convert missing or stale images.
- Set Images per run if you have a large library (default 25). The task continues on the next run if more files remain.
- Save the task and enable it.
Those files are also converted when someone later opens a page that uses them. If you have size limits set, the scheduled task makes the limited-size copy; a page view makes a full-size copy.