How to Fix: Image dimensions specified

Image dimensions specified is an important SEO check in the Site Performance & Core Web Vitals category. This is a high-priority SEO issue that should be addressed soon. It has a significant impact on your SEO performance.

You have felt this bug even if you have never named it: you go to tap a button, an image finishes loading above it, the whole page lurches down, and you tap the wrong thing. That lurch is layout shift, and images without declared dimensions are the most common cause. This check wants every image to reserve its space before it loads, so the page holds still. It is a direct input to your Cumulative Layout Shift score, and CLS is one of the Core Web Vitals Google actually ranks on.

What This Check Is Really About

The check verifies that your images carry explicit width and height attributes (or an equivalent CSS aspect-ratio). When the browser knows an image’s proportions before the file arrives, it can reserve exactly the right box and lay the rest of the page around it immediately. Without those numbers, the browser reserves nothing, renders the text, then shoves everything down when the image finally loads — the definition of a layout shift.

When it fails, your images are being output without dimensions — often from hand-written HTML, a page builder, or a lazy-loading script that strips them.

Why This Matters for SEO

• CLS is a ranking signal. Cumulative Layout Shift is part of Core Web Vitals, which feed Google’s page experience signals directly.
• Layout shift wrecks usability. Mis-taps and jumping content are among the most infuriating things a mobile visitor experiences, and they drive people away.
• Reserved space speeds perceived load. A stable layout feels faster and more trustworthy even at the same raw load time.
• It compounds with lazy loading. Done right, dimensions plus lazy loading give you both speed and stability; done wrong, lazy loading alone makes shift worse.

Reserve the Box First: An Old Print Instinct

This problem is new to the web but old to anyone who came up in print, and it is one place my dinosaur instincts transfer perfectly. In page-layout work — I spent years in QuarkXPress and Aldus FreeHand — you never poured text onto a page and hoped an image would fit somewhere later. You drew the picture box first, at its exact dimensions, and the text flowed around a hole you had already reserved. The image itself might arrive from the photographer a week later; the layout did not care, because the space was already committed. Change the picture, keep the box, and nothing else on the spread moved.

Declaring width and height is the exact same move: you are drawing the picture box before the image loads. The browser reflowing a page because an image showed up unannounced is precisely the amateur mistake a good layout artist was trained out of thirty years ago — commit the space up front, and the content never jumps. The technology changed; the discipline did not.

How to Fix This in WordPress

Difficulty Level: MEDIUM – This fix requires some technical knowledge or familiarity with WordPress settings and plugins.

Estimated Time: varies

1. Rely on core where you can. Modern WordPress adds width and height to images in the editor automatically; the problems usually live in custom templates, builders, and manual HTML.
2. Audit custom output. Anywhere you or a theme prints <img> by hand, add the dimensions — or set a CSS aspect-ratio on the container so the box is reserved even for responsive images.
3. Check your lazy-loading setup. A misbehaving lazy-load script that strips or defers dimensions is a frequent culprit; make sure it preserves the attributes.
4. Keep images responsive without losing the box. Pair explicit dimensions with max-width:100%;height:auto so images scale fluidly while the aspect ratio still reserves space.
5. Measure the result. Run PageSpeed Insights and watch the CLS field data in Search Console’s Core Web Vitals report to confirm the shift is gone.

Recommended Tools & Plugins

• Yoast SEO – Comprehensive SEO plugin with built-in checks
• Rank Math – Feature-rich SEO plugin with detailed analysis
• Google Search Console – Free tool to monitor your site’s search presence
• SEO Roadmap – Complete SEO audit and action plan tool

Common Mistakes to Avoid

• Hand-coding <img> tags in templates without width and height
• Using a lazy-loading script that strips the dimension attributes and reintroduces shift
• Setting only width or only height, so the aspect ratio is still ambiguous
• Assuming CSS sizing alone fixes it — the browser needs the ratio before the stylesheet-dependent layout settles

This guide is part of the SEO Roadmap knowledge base – your complete resource for WordPress SEO optimization.