Crystal Ball checks covered

IMAGE_DIMENSIONS_MISSING, layout shift, CMS image templates

What the flag means

Crystal Ball flags this when image tags are missing width and height information. Those attributes help the browser know how much space to save while the image loads.

The problem is layout shift. If an image loads late and suddenly pushes text, buttons, or forms down the page, visitors can lose their place or tap the wrong thing. It also makes the page feel less stable. This is less about magic rankings and more about not making the floorboards move under people’s feet.

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.

How to fix it

  • 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.