---
title: "Viewport meta missing, not device-width, or blocks zoom (seo/viewport)"
description: "seo/viewport: Google indexes the mobile rendering; without width=device-width the page renders at desktop width on phones."
canonical: https://void-design.vercel.app/rules/seo/viewport
lastModified: 2026-09-16
---

# Viewport meta missing, not device-width, or blocks zoom

`seo/viewport` · severity **error** · category SEO · detected by `void seo` and `void audit`

## Why it matters

Google indexes the mobile rendering; without width=device-width the page renders at desktop width on phones. Blocking zoom fails accessibility.

## How to fix it

Emit <meta name="viewport" content="width=device-width, initial-scale=1">. Next.js adds it by default; don't override with maximum-scale=1 or user-scalable=no.

## Example

```ts
// app/layout.tsx — themeColor etc. go in viewport, never maximumScale: 1
export const viewport: Viewport = { width: 'device-width', initialScale: 1 }
```

## References

- https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing
- https://nextjs.org/docs/app/api-reference/functions/generate-viewport

## More seo rules

`void seo` reports 60 rules in this category. What search engines need from the raw response: status codes, titles and descriptions in <head>, self-referencing canonicals, one h1, crawlable links, Open Graph, icons, robots.txt and a sitemap with real dates.

- `rsc-payload-ratio` Inline RSC flight payload dominates the HTML — [seo/rsc-payload-ratio](https://void-design.vercel.app/rules/seo/rsc-payload-ratio)
- `not-https` Page served over plain HTTP — [seo/not-https](https://void-design.vercel.app/rules/seo/not-https)
- `origin-redirects` http:// or www/apex variant doesn't redirect to the canonical origin in one hop — [seo/origin-redirects](https://void-design.vercel.app/rules/seo/origin-redirects)
- `html-lang` <html lang> missing or not a valid BCP 47 tag — [seo/html-lang](https://void-design.vercel.app/rules/seo/html-lang)
- `charset` Character encoding not declared early — [seo/charset](https://void-design.vercel.app/rules/seo/charset)
- `title-missing` No single non-empty <title> in <head> — [seo/title-missing](https://void-design.vercel.app/rules/seo/title-missing)
- `title-length` Title length outside 10–60 characters, or keyword-stuffed — [seo/title-length](https://void-design.vercel.app/rules/seo/title-length)
- `meta-description-missing` No meta description in <head> — [seo/meta-description-missing](https://void-design.vercel.app/rules/seo/meta-description-missing)

Detected by `void seo` and `void audit`. Explain it in a terminal: `void rules seo/viewport`
