Trellis Images is a plugin that can be paired with your Trellis WordPress theme to non-destructively generate next generation image formats (.webp, in this case) and serve those formats to compatible browsers.

When we say "non-destructively", we mean that Trellis images will not modify or change your existing images. It will only use those images as a resource to generate new images as .webp

Trellis Images will only generate and serve next-gen formats from images stored and served from your WordPress media library. It will not perform for images served from a remote CDN or remote URL, but should work as intended if you're using a fully sitewide CDN. Your host should be able to provide more information on leveraging a CDN for your website.

❗ Note: Trellis Images will create and save WebP versions of images in your image library which will increase the size of your image library.

We recommend talking to your host to ensure you have enough server space to support the use of this plugin. It may be necessary to purchase more space on your server, but this is dependent on how much space you have left, the number of images on your site, and the original size of these images.

By default, WordPress creates 7 different image sizes for each image you upload. However these 7 image sizes aren't enough for Google PageSpeed Insights' standards, so Trellis will also create 8-9 additional image sizes. Lastly, if you use Trellis Images, then each of your image sizes will get a webp version to meet modern web standards and optimization.

If you can't accommodate this additional storage, don't worry since Trellis Images isn't a required plugin and Trellis can still deliver site speed improvements.

If you've purchased a Trellis License in the Mediavine Marketplace, you'll find a link to download the Trellis Images plugin from your Marketplace account downloads page.

Once you've downloaded the plug-in you can follow the steps in this document to upload and activate the plug-in for your site.

Trellis Images has no settings. You just need to install it, activate it, and give it time to generate and serve the new formats. In most cases, serving next-gen image formats can result in higher PageSpeed scores and better performance scores in Lighthouse.

If you disable Trellis Images at any point, your originally uploaded images will be served instead. This should result in no downtime for your site or your images.