Crystal Ball checks covered

IMAGE_DIMENSIONS_MISSING, layout shift, CMS image templates

Guide detail

Choose Your Technical Level

This setting applies to the meaning, causes, and fix sections. Your choice carries to other Fix Library guides on this device.

Practical explanations and page-specific steps. Recommended for most readers.

What the flag means

Crystal Ball flags image tags that lack intrinsic width and height information. When both values are present, the browser can calculate the image's aspect ratio before the file finishes loading, while responsive CSS can still control its displayed size.

The practical concern is layout shift. If a late image pushes text, buttons, or forms down the page, visitors can lose their place or activate the wrong control. Stable image space supports usability and more reliable Core Web Vitals measurement.

Common causes

Common causes include hand-coded images, custom CMS themes, lazy-loaded images, page builder modules, embedded widgets, and image snippets that output src and alt but not dimensions.

What to check next

Check whether the issue appears on one page or every page using the same template. Review recent content, theme, plugin, deployment, and server changes, then compare the live output with a known-good page.

How to fix it

Confirm the warning first and make a backup before editing the live site. If the change involves templates, code, DNS, redirects, or server settings, switch to Intermediate or ask for help before proceeding.

  • Custom HTML/static: Add width and height attributes to <img> tags or reserve space with CSS aspect-ratio. web.dev recommends image dimensions to reduce layout shift.
  • WordPress: Modern WordPress usually outputs image dimensions, but custom themes or page builders can strip them. Check the template, image block output, and custom image sizes. WordPress documents custom image sizes.
  • Shopify: Check theme image snippets and Liquid output if dimensions are missing. Shopify documents theme image behavior and lazy loading.
  • Wix: Wix usually handles image sizing, so repeated warnings may come from custom embeds, HTML widgets, or unusual image containers. Start with Wix's image settings.
  • Webflow: Set image sizing clearly in the Designer and use responsive image settings. If custom embeds output raw images, add dimensions or CSS aspect ratio manually. See Webflow's Image element guide.

Need help?

If the fix gets murky, visit Support and send the details. Bug reports and Crystal Ball questions are free support. Implementation and development work may be paid support, but we will tell you clearly before anything becomes paid. No surprise invoices from the tower.