Automatically generate and serve .webp images from existing .jpeg, .png, and .gif files.

Installs: 397

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 13


dev-master 2023-09-17 16:34 UTC

This package is auto-updated.

Last update: 2024-02-03 14:25:54 UTC


Build Status License


You can read more about the modifications made to this fork, and the reasoning behind it at the link below.

Tips for Optimizing Page Speeds


I've modified this add-on so that .webp that are created possess the file name of file_name_goes_here.<original extension>.webp. The reason for this is so that the images created can be automatically served in place of their original image assets by using a NGINX configuration such as the one below.

map $http_accept $webp_suffix {
  default   "";
  "~*webp"  ".webp";

location ~* /assets/.+\.(?<extension>jpe?g|png|gif|webp)$ {
    # more_set_headers 'Content-Type: image/webp';
    gzip_static on;
    gzip_types image/png image/x-icon image/webp image/svg+xml image/jpeg image/gif;

    add_header Vary Accept;
    expires max;
    sendfile on;
    try_files "${request_uri}${webp_suffix}" $uri =404;

The variable webp_suffix will be populated with the .webp extension if the requesting web client has webp defined as part of its Accept header. NGINX will then attempt to find the .webp version of the asset, and failing that, it will serve the original instead.


This module creates webp images from resized jpeg and png images. More Information about webp images


  • Silverstripe > 4.2
  • GDLib with webp Extension


composer require loveduckie/silverstripe-webp-image


  • run dev/build?flush=1

  • force Browser to load webp image // Example 1 (default) edit .htaccess in your root directory, and add webp forwarding in compatible browsers

  • force Browser to load webp image // Example 2 for information on usage of webp image in html see

Quick Testfile for checking if webp is available

Below you will find the code to quickly check if webp is available with the installed GD Library. Simply copy this code into a .php file in your root folder and open the file in a browser.


if (function_exists(imagewebp)) {
    echo "WebP is available";
} else {
    echo "WebP is not available";


  • documentation
  • IMagick Support
  • PHP test to check support
  • Delete Webp Image
  • Flush Webp Image