Crystal Ball checks covered

VIEWPORT_MISSING, VIEWPORT_INCOMPLETE, mobile layout warnings

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 viewport problems when a page is missing the standard mobile viewport tag or appears likely to render poorly on smaller screens.

Without correct viewport handling and responsive CSS, visitors may see a zoomed-out desktop layout, horizontal scrolling, tiny text, or awkward tap targets.

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.

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