How to fix meta viewport large on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. SSH into your server or use your IDE to open your active theme directory, typically located at app/design/frontend/<Vendor>/<theme>/.
2. Find or create the file: Magento_Theme/layout/default_head_blocks.xml OR locate the root layout XML that renders the viewport tag.
3. Alternatively, search your theme's .phtml or layout XML files for 'viewport' and locate where the tag is output.
4. Edit the <meta name="viewport"> content attribute to remove maximum-scale restrictions.
5. Run bin/magento cache:flush after saving, then verify on a mobile device.

What is meta viewport large?

Every webpage can include a small HTML tag called the "meta viewport" tag that tells mobile browsers how to display the page. One option inside that tag, `maximum-scale`, sets an upper limit on how far a user can zoom in. When `maximum-scale` is set to a value less than 5 (for example, `maximum-scale=1` or `user-scalable=no`), it physically prevents visitors from pinching to zoom — meaning they cannot make text or images larger, no matter how hard they try. This is the issue your scanner flagged.

Blocking zoom is a significant accessibility barrier for the roughly 2.2 billion people worldwide who have some form of vision impairment. Many low-vision users rely entirely on browser or OS zoom to read product descriptions, prices, and checkout instructions — locking zoom means they simply cannot use your store. Under WCAG 2.1 Success Criterion 1.4.4 (Resize Text), text must be resizable up to 200% without loss of content or functionality; a zoom-blocking viewport tag directly violates this criterion. This matters legally too: the ADA, EN 301 549 (EU), and equivalent accessibility laws increasingly cite WCAG conformance, so non-compliance creates real litigation and regulatory risk. Fixing it costs almost nothing (a one-line HTML change) and immediately improves usability for every visitor on a mobile device.

See the complete Meta viewport large guide for every platform and the full background.