Support
How can we help?
Most questions are solved here in a minute. If not, we help you personally.
Troubleshooting
Images not visible after converting
Usually a cache. Clear the page cache, your CDN (such as Cloudflare) and Varnish. Test on the System & help tab whether your server sends the right type for .webp and .avif. Oxygen: regenerate its CSS cache.
Start button does not work or AVIF is greyed out
Your server cannot create that format. The system check shows what is missing: Imagick or GD with WebP or AVIF support. Your host can usually switch it on.
Timeouts (504) on cheap hosting
Lower the batch length under Settings → More options → Advanced and set the AVIF effort to 3 or 4. For large libraries, wp verklein convert is fastest.
Some images are skipped
Restore & clean up lists the reason per image. Often the result was not smaller, so the original was kept. Try all of them again includes them in the next run.
Broken image URLs
Use Repair broken URLs on Restore & clean up, or wp verklein repair. URLs of files that do exist are never changed.
A task stopped
Everything that is done is kept. Start again, or finish it with wp verklein job run. Update the URLs afterwards if needed.
Frequently asked questions
Will visitors on an old iPhone or Mac see the images?
WebP works in every current browser, and in Safari from version 14. Safari only shows AVIF from version 16. To serve older Apple devices as well, choose WebP or the fallback mode. There, with AVIF, Safari 14 and 15 get the WebP copy, and a browser that knows neither gets the original file.
Should I pick WebP or AVIF?
WebP, for almost every site. AVIF is smaller but much slower to create, and Safari 15 and older, many social media link previews and most e-mail clients do not show it. If you do go for AVIF, use the fallback mode.
Does it work with a CDN such as Cloudflare?
Yes. Clear your CDN cache after converting, because the plugin cannot do that for you. If your database contains URLs with your CDN host name, add that host with the verklein_rewrite_hosts filter. With <picture> in fallback mode a CDN needs nothing else. If you use the Accept-header rule, your CDN must respect the Vary: Accept header, or an old browser may still get the WebP. The System check tests that rule.
I use nginx. What do I do about the backup folder?
nginx ignores the .htaccess file that closes the backup folder, so add a rule to your server configuration yourself. The second rule passes old JPG and PNG URLs to WordPress, for the 301 redirect. The exact folder name is on the System & help tab, and the System check tests whether the folder is closed. The rules are in the documentation.
Can I undo everything?
Yes, as long as the originals are in the backup folder or were left in place, which is the default. Go to verklein.nu → Restore & clean up, restore single images in the Media Library, or use wp verklein restore. Once you have deleted the backups, or had the originals deleted, it is no longer possible.
How much disk space do I need?
While converting, the new files sit next to the old ones, and the originals are kept as a backup. So count on some extra space for a while. Once you are happy, delete the backups and only the smaller files remain. In fallback mode the original and the copy both stay. The System check shows how much space is free.
Does it work with Elementor, Divi or another page builder?
Yes. The URL update handles plain text, HTML, JSON with escaped slashes and serialized PHP data, the way Elementor, Divi, Beaver Builder, Oxygen, Bricks, WPBakery and Avada store them. The CSS cache of Elementor, Beaver Builder, Divi and Avada is cleared automatically. On Oxygen, regenerate the CSS cache under Oxygen → Settings.
What does it do to my SEO?
Smaller images load faster, which is good for how quickly your pages load. The title, alt text and ID of your images stay the same. In replace mode the file name changes from .jpg to .webp, but the plugin can redirect old URLs with a 301, so links from other sites and Google Images keep working.
Imagick or GD: does it matter?
Both work. Imagick is preferred: it gives better quality, keeps colour profiles and supports the effort setting. Whether your server can create AVIF depends on how Imagick or GD was built. The System check tells you; if not, your host can usually switch it on.
Why is AVIF so slow?
Creating AVIF files takes a lot of computing. Expect 3 to 20 seconds per image including every size, against half a second to two seconds for WebP. A large library can take hours. Set the effort to 3 or 4 on slow hosting, and use WP-CLI for thousands of images.
My media is in the cloud. Will it work?
Only for files that are still on your own server. With WP Offload Media, Media Cloud or WP-Stateless the plugin warns you up front, and it does not upload the converted files to the cloud.
What happens when I delete the plugin?
Your converted images, the copies from fallback mode and the backup folder always stay, so your site keeps working. In fallback mode it shows the original JPGs and PNGs again. Settings and restore data are kept by default too, so you can still restore after reinstalling. To remove everything, first switch on Remove all plugin data when the plugin is deleted in the settings. To go back to the originals, restore before you delete the plugin.
Still have questions?
E-mail us. Include this, so we can help you faster:
- The output of
wp verklein status, or a screenshot of the system check - Which settings you use (replace or next to the original, WebP or AVIF)
- What you see and what you expected
General questions about verklein.nu? See the contact page.