GTMRun

JavaScript rendering: verify Google sees it

Last updated: 2026-11-16

Google recommendation

What it is #

Many modern sites send a nearly empty HTML "shell" and build the page in the browser with JavaScript (React, Vue and Angular single-page apps). Google renders JavaScript too, but in a separate, later step, and it only indexes what shows up in the rendered HTML.

Why it matters #

When rendering works, you're fine. When it doesn't (a blocked script, an API call that fails for Googlebot, content that only loads after a click), Google indexes a blank page. Other crawlers and link previews often don't run JavaScript at all.

How we check it #

We read your homepage's raw HTML. If it contains fewer than 50 words of visible text plus a script, we treat it as a JavaScript-rendered shell. Then:

  • this check shows as info, not a failure;
  • the content checks we can only judge from HTML (headings, media, structured data, call to action, email capture) show not measured instead of failing, because Google renders JavaScript and we don't.

How to fix #

  1. Check what Google actually renders. Search Console → URL Inspection → enter your homepage → Test live URL → View tested page → HTML / Screenshot. If your headline, copy and links are there, you're OK.
  2. If content is missing: look at More info → Page resources for blocked or failed scripts, and unblock them in robots.txt.
  3. Best fix for marketing pages: serve real HTML with server-side rendering or prerendering (Next.js, Nuxt, Astro, or a prerender step for your SPA's public routes). Keep client-side rendering for the logged-in app.

Verify it yourself #

curl -s https://yourdomain.com/ | sed -e 's/<[^>]*>/ /g' | wc -w

This counts roughly how many words are visible without JavaScript.

Runs GTMRun's own checks only — seconds, no third-party calls.

Tips #

  • Put meta tags and structured data in the initial HTML when you can. Google does read JavaScript-injected tags, but other platforms often don't.
  • Links must be real <a href> links for Google to follow them. onClick navigation isn't crawlable.
  • What we learned: gtmrun.co, universalapi.co and bookme.contractors are all React app shells with 4–12 visible words in raw HTML. Our first AI-readiness check marked all three as missing headings and images. The same failure on three different sites told us the check was broken, not the sites, so these checks now say "not measured".

Sources #