Skip to main content
Checks for image files that exceed recommended size limits
Rule IDimages/image-file-size
CategoryImages
ScopeSite-wide
Severityerror
Weight7/10

​
Solution

Large images slow down page loads and impact Core Web Vitals. Compress oversized images, use modern formats (WebP/AVIF), and resize images to the display dimensions. Consider responsive images with srcset to serve smaller files on mobile.

​
Options

This rule supports the following configuration options:
OptionTypeDefaultDescription
warn_bytesnumber204800 (200KB)Byte size to trigger warning
error_bytesnumber1048576 (1MB)Byte size to trigger error

​
Configuration Example

squirrel.toml
[rules."images/image-file-size"]
warn_bytes = 204800
error_bytes = 1048576

​
Enable / Disable

​
Disable this rule

squirrel.toml
[rules]
disable = ["images/image-file-size"]

​
Disable all Images rules

squirrel.toml
[rules]
disable = ["images/*"]

​
Enable only this rule

squirrel.toml
[rules]
enable = ["images/image-file-size"]
disable = ["*"]