HTML Size

Checks HTML document size against Googlebot crawl limits

Rule ID	crawl/html-size
Category	Crawlability
Scope	Per-page
Severity	error
Weight	5/10

Solution

Googlebot truncates HTML documents at 2MB: content beyond that limit is silently ignored during indexing. Move inline styles and scripts to external files, defer non-critical content, lazy-load below-the-fold sections, and remove unnecessary markup. Keep critical SEO content (title, meta, headings, main body) near the top of the document so it’s indexed even if truncation occurs.

Options

This rule supports the following configuration options:

Option	Type	Default	Description
warn_bytes	unknown	undefined	Byte size to trigger warning
error_bytes	unknown	undefined	Byte size to trigger error (Googlebot truncation limit)

Configuration Example

[rules."crawl/html-size"]
warn_bytes = undefined
error_bytes = undefined

Enable / Disable

Disable this rule

[rules]
disable = ["crawl/html-size"]

Disable all Crawlability rules

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

Enable only this rule

[rules]
enable = ["crawl/html-size"]
disable = ["*"]