Skip to main content
Once Bunny Optimizer is enabled, it automatically optimizes your static assets without any code changes. This guide covers the available configuration options.

​
WebP Image Compression

Automatically converts images to WebP format for supported browsers, reducing file sizes by up to 80% while maintaining visual quality. How it works:
  • Original URLs remain unchanged (e.g., image.jpg)
  • WebP is served transparently when supported
  • Verify by checking the content-type header: image/webp
  • Unsupported browsers receive the original format

​
Smart Image Optimization

Serves appropriately sized images based on device type (desktop vs mobile). Configuration:
  • Maximum desktop image width: Images larger than this are automatically downsized
  • Maximum mobile image width: Separate sizing for mobile devices
  • Desktop image quality: 0-100% (recommended: 85-90%)
  • Mobile image quality: 0-100% (recommended: 75-85%)
Lower quality settings on mobile save bandwidth without noticeable quality loss on smaller screens.

​
CSS & JavaScript Minification

Minification strips whitespace, comments, and unnecessary characters from your CSS and JavaScript files, reducing file sizes and improving download times without changing functionality. CSS and JavaScript minification can be toggled independently in your Optimizer settings.

​
When to enable

Enable minification if your files are not already minified. This reduces bandwidth usage and improves load times.

​
When to disable

Disable minification if your files are already minified. Re-processing pre-minified files adds serving latency with no meaningful size reduction.

​
Mixed environments

Files named *.min.js or *.min.css are automatically excluded from optimization. This allows you to keep minification enabled for unminified files while avoiding redundant processing for others. Ensure pre-minified files to follow the .min.js / .min.css convention.