Users are experiencing issues where PageSpeed Insights reports a missing viewport meta tag despite it being present in their Shopify theme code. The tag appears correctly inserted in the <head> section with proper syntax (<meta name="viewport" content="width=device-width, initial-scale=1">), but the error persists.
Troubleshooting attempts that failed:
Verifying placement within <head> section
Checking for syntax errors and conflicting code
Clearing browser cache
Positioning the tag immediately after the <head> opening tag
Successful resolution:
One user identified the root cause as a third-party Shopify app (specifically a fraud/visitor blocking app) that was interfering with the viewport tag detection. After uninstalling the conflicting app, PageSpeed Insights correctly recognized the meta tag and metrics improved.
Current status: The issue appears solvable by identifying and removing conflicting third-party apps rather than modifying the viewport tag code itself.
Summarized with AI on October 29.
AI used: claude-sonnet-4-5-20250929.
As you can see in the attached image, the meta name=“viewport” tag has been inserted, but PageSpeed Insights still throws an error no matter how many times I try.
It looks like you’re facing an issue with the <meta name="viewport"> tag not working as expected. The viewport meta tag is crucial for ensuring proper responsiveness and display on different devices. Here are a few steps you can take to troubleshoot and resolve the issue:
Verify the placement: Make sure the <meta name="viewport"> tag is placed within the <head> section of your HTML code. It should be placed before any other CSS or JavaScript files.
Check for conflicting code: Ensure that there are no conflicting CSS or JavaScript codes that might be overriding or interfering with the viewport settings. Look for any other viewport-related tags or CSS properties that might be conflicting.
Check the syntax: Double-check the syntax of the viewport tag to ensure it is correct. It should resemble the following:
Pay attention to the placement of quotes, commas, and the values of the content attribute.
Clear cache: If you have previously tested the <meta name="viewport"> tag and it didn’t seem to work, try clearing your browser cache. Sometimes, cached versions of your website might not reflect the recent changes you made.
I have faced the same issue. It was caused by another app I installed for blocking frauds and visitors from specific countries. After uninstalling it, all my pagespeed metrics became green as the meta tag was detected at last.