Crystal Ball checks covered

VIEWPORT_MISSING, VIEWPORT_INCOMPLETE, mobile layout warnings

What the flag means

Crystal Ball flags viewport problems when a page is missing the standard mobile viewport tag or appears likely to render poorly on smaller screens.

This is a problem because mobile visitors may see a zoomed-out desktop page, horizontal scrolling, tiny text, or awkward tap targets. The page may be technically alive, but not hospitable.

Common causes

Common causes include old templates, hand-coded landing pages, custom headers, stripped head markup, duplicate viewport tags, fixed-width sections, wide tables, and embeds that refuse to shrink.

How to fix it

  • Custom HTML/static: Add <meta name="viewport" content="width=device-width, initial-scale=1"> in the HTML head and use responsive CSS.
  • WordPress: Most modern themes include viewport tags. If the flag appears, check custom landing pages, header templates, or theme files.
  • Shopify: Most themes include a viewport tag. If it is missing, review theme.liquid or any custom landing-page templates.
  • Wix: Wix handles viewport basics, so focus on mobile layout settings and page sections that overflow on small screens.
  • Webflow: Webflow includes viewport handling. Use responsive breakpoints to fix layout overflow rather than adding duplicate viewport tags.

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.