HTML Document Too Large
What This Means
The raw HTML source of the page is significantly larger than the typical threshold — usually measured in hundreds of kilobytes or more. The page has an unusually large HTML document size.
Why It Matters for SEO
Googlebot has a limit on how much of a page's HTML it processes — typically around 15MB, but in practice issues can arise with documents that are significantly smaller. Very large HTML files also: slow download time for all users; increase parse time; and often indicate problematic patterns — inline data, thousands of items without pagination, or uncompressed HTML output.
Very large HTML documents are often caused by: large datasets rendered inline in the HTML (JSON data, full product catalogs); JavaScript frameworks rendering large amounts of server-side HTML; or uncompressed, un-minified HTML output from a CMS.
What the Platform Checks
The platform records the raw HTML response size for each crawled page. Fires when the size exceeds the maximum threshold.
How to Fix It
- Paginate large content: If the page lists hundreds or thousands of items, paginate rather than rendering all items on one page.
- Lazy load content: For content not visible in the initial viewport, load it dynamically via JavaScript.
- Move data out of HTML: Large JSON data blocks embedded in the HTML should be fetched via API instead.
- Enable HTML compression: Ensure your server serves HTML with gzip or Brotli compression.
- Minify HTML: Remove comments, extra whitespace, and redundant attributes from HTML output.
Find every oversizedHTML document
The audit measures HTML document sizes and flags pages exceeding the threshold so you can reduce their size.