What it Checks
Google retired its Mobile-Friendly Test in December 2023. This test renders each page in Chromium on a 412px-wide screen (as Googlebot Smartphone by default) and measures the same problems, close to the way Lighthouse does:
| Problem | Reported when |
|---|---|
| Viewport not set | The page has no <meta name="viewport">. |
| Viewport not set to device-width | The viewport has no width=device-width: a fixed width, or only initial-scale (browsers often infer the width from it, but Google's guidance asks for width=device-width, initial-scale=1). |
| Content wider than screen | The page scrolls sideways: it is wider than the 412px screen. |
| Text too small to read | Less than 60% of the visible text is displayed at 12px or larger. Without a device-width viewport the page is scaled down to the screen, and the text with it. |
| Clickable elements too close together | More than 10% of the tap targets (Lighthouse's pass mark) are smaller than 48×48px with another target within their 48px area. Two links to the same page count as one target. |
| Uses incompatible plugins | The page embeds Flash or a Java applet. |
A page with none of these problems is mobile-friendly. Two notes are reported without failing the page: Zoom disabled (user-scalable=no or a maximum-scale under 2) and Some tap targets are small (crowded targets under the 10% mark).
Run a Test
- Paste the URLs, one per line (up to 50; duplicates are tested once).
- Press Test. Progress shows each page as it finishes; you can cancel. The verdict reads The page is mobile-friendly., All 12 tested pages are mobile-friendly. or, for example, 3 of 12 tested pages are not mobile-friendly.
- A link to
/tools/mobile-friendly?url=https://example.com/&run=1fills in the URL and runs the test.
Options
- User agent. Any smartphone user agent from the user-agent list. Googlebot Smartphone, the crawler Google indexes with, is the default; pick Chrome (Android Mobile) when a site refuses requests claiming to be Googlebot.
Every page is rendered on a 412px-wide screen. To compare a page's mobile and desktop versions, use the Mobile-First Index Tool.
Reading the Result
- Problems: every problem found, most common first, with the number of pages it affects.
- Not tested: pages that got no verdict, because they answered an error status or failed to load.
- Mobile-friendly / With problems / Not tested (several URLs): the count of pages in each state.
- Pages: one row per URL with its status, verdict (yes, no or not tested), problems and share of legible text. Expand a row for the phone screenshot (first screen), each problem and note in detail, the final URL, the viewport, the tap targets measured and the small, crowded ones with the target each is too close to (up to 50). The table exports to CSV and Excel.
Good to Know
- Three pages are rendered at a time; a list of 50 takes a few minutes.
- Measurements are taken once the page has loaded and the network is quiet (up to 6 seconds). Up to 5,000 tap targets are measured per page.
- Robots rules apply to Googlebot, not to this test: check them with the robots.txt Tester.
API
POST /api/mobile-friendly
Send the URLs as one string, one per line, and optionally a smartphone user-agent id (agent, Googlebot Smartphone by default). The answer is JSON with every row in input order; each row also carries a base64 JPEG screenshot. Pages not tested have mobileFriendly: null and an error. With "stream": true the answer is NDJSON instead: a {"type": "row", "done", "total", "url", "mobileFriendly"} line as each page finishes, then {"type": "done", "agent", "rows"}.
curl -X POST https://plumb.reacthive.dev/api/mobile-friendly \
-H "content-type: application/json" \
-d '{
"urls": "https://www.spacejam.com/1996/\nhttps://www.airbnb.com/",
"agent": "googlebot-smartphone"
}'{
"agent": "Googlebot Smartphone",
"rows": [
{
"url": "https://www.spacejam.com/1996/",
"finalUrl": "https://www.spacejam.com/1996/",
"status": 200,
"mobileFriendly": false,
"issues": [
{
"id": "viewport",
"label": "Viewport not set",
"detail": "The page has no <meta name="viewport">: phones lay it out 980px wide and show it zoomed out."
},
{
"id": "font-size",
"label": "Text too small to read",
"detail": "Only 0% of the text is displayed at 12px or larger (at least 60% should be); the page is scaled down from 981px to the 412px screen."
},
{
"id": "tap-targets",
"label": "Clickable elements too close together",
"detail": "6 of 15 tap targets (40%) are smaller than 48×48px and close to another target; more than 10% fails."
}
],
"warnings": [],
"legibleTextPercent": 0,
"viewport": "",
"tapTargets": 15,
"smallTapTargets": [{ "text": "Press Box Shuttle", "width": 17, "height": 12, "near": "Jam Central" }],
"smallTapTargetCount": 6,
"screenshot": "data:image/jpeg;base64,/9j/4AAQ..."
},
{
"url": "https://www.airbnb.com/",
"status": 403,
"mobileFriendly": null,
"issues": [],
"error": "Not tested: the page answered HTTP 403 to Googlebot Smartphone, and an error page isn't the page. ..."
}
]
}