Image File Size Too Large

Checks for image files that exceed recommended size limits

Rule ID	images/image-file-size
Category	Images
Scope	Site-wide
Severity	error
Weight	7/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:

Option	Type	Default	Description
warn_bytes	number	204800 (200KB)	Byte size to trigger warning
error_bytes	number	1048576 (1MB)	Byte size to trigger error

Configuration Example

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

Enable / Disable

Disable this rule

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

Disable all Images rules

[rules]
disable = ["images/*"]

Enable only this rule

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