Modern Web Guidance: How Google Is Fixing AI-Written Website Code
Modern Web Guidance is Google's free add-on that teaches AI coding tools like Claude Code to use modern browser features. Here's what version 1.0 fixes, what AI still gets wrong and what it means for your website.
Translate
Read this page in
- Español
- Français
- Deutsch
- Italiano
- Português
- Nederlands
- Polski
- Svenska
- Ελληνικά
- Türkçe
- Русский
- Українська
- العربية
- עברית
- فارسی
- हिन्दी
- বাংলা
- اردو
- සිංහල
- தமிழ்
- नेपाली
- 简体中文
- 繁體中文
- 日本語
- 한국어
- Tiếng Việt
- ไทย
- Bahasa Indonesia
- Bahasa Melayu
- Filipino
- Kiswahili
Translated by Google in a new tab. Pick any other language from Google’s bar at the top of that page.
On this page11 sections
- What is Modern Web Guidance?
- Why AI tools write outdated website code
- How Modern Web Guidance works
- A simple example: a pop-up window
- What Modern Web Guidance means for your website
- How to install Modern Web Guidance
- What Modern Web Guidance won’t do
- What it means for Australian businesses
- Common questions
- How I can help
- Sources
Modern Web Guidance is a free add-on from Google Chrome that teaches AI coding tools, such as Claude Code, Codex and Cursor, to build websites with modern browser features instead of old, heavy JavaScript. Version 1.0 came out on 10 November 2026, and Firefox and Microsoft Edge have now joined the project.
In short, it helps AI-written websites load faster, work better for people with disability and stay safer from attacks. In Chrome’s own tests, AI tools pass about half of its best-practice checks on their own, and around 90% with the guidance installed.
I’m Jay, a Melbourne-based freelance web developer and Fiverr Pro. I build custom websites for businesses around the world, and here’s what this release means for your website, whether you write code or not.
What is Modern Web Guidance?#
Modern Web Guidance is a set of expert-written guides that an AI coding tool reads while it works. It isn’t a new AI model or a website builder. Think of it as a reference book the AI checks before it writes code for a common task, like a pop-up, a form or a page transition.
| Detail | Modern Web Guidance |
|---|---|
| Made by | Google Chrome, with Firefox and Microsoft Edge joining for version 1.0 |
| First released | Early preview at Google I/O, May 2026 |
| Stable version | 1.0, released 10 November 2026 |
| Cost | Free and open source (Apache 2.0 licence) |
| Works with | Claude Code, Codex, Cursor, Antigravity, GitHub Copilot, WebStorm, Kimi Code and Grok Build |
| Covers | Accessibility, user experience, performance, security, forms and layout |
The guides are written and checked by browser engineers, web standards experts and accessibility specialists. Each one also carries browser support data from Baseline, the shared list of features that work across all major browsers. So the AI can choose a feature your visitors’ browsers actually support, with a light fallback for older ones.
Why AI tools write outdated website code#
AI models learned to code from years of existing websites, and most of that code was written before today’s browser features existed. So when you ask for a pop-up or a swipe gesture, the AI often does it the old way. It writes lots of custom JavaScript that works, but is slower, harder to maintain and easy to get wrong for keyboard and screen reader users.
Chrome tests this on every guide. Without the guidance, AI coding tools passed only about 50% of its checks. With it, they passed around 90%. These are the 10 areas where Chrome found AI tools slip up most, and what that means for the people using your site.
| Area | Common AI mistake | What your visitors notice |
|---|---|---|
| Keyboard focus | Doesn’t move focus into a new window, or back again after it closes | Keyboard and screen reader users get lost on the page |
| Reduced motion | Smooth scrolling and page transitions ignore the phone’s “reduce motion” setting | Animations can cause dizziness or nausea for some people |
| Forms | Errors show too early, and format hints sit where the phone keyboard covers them | Frustrating checkouts and abandoned enquiries |
| Swipe gestures | Swipes built with heavy JavaScript instead of the browser’s own scrolling | Swiping feels laggy compared with an app |
| Pop-ups and menus | Hand-built overlays, scroll locks and animations | Glitchy pop-ups, and the Android back gesture doesn’t close them |
| Dark mode | Missing settings that tell the browser the site supports dark mode | A white flash on load and form fields stuck in light colours |
| Responsiveness | Heavy work blocks the page after a tap or click | Buttons feel slow to react (a poor INP score) |
| Layout shifts | Videos, fonts and mobile toolbars aren’t given space | Content jumps around while the page loads (a poor CLS score) |
| Security | No Content Security Policy unless asked, and home-made HTML cleaners | More risk of a cross-site scripting attack |
| Passkeys | Manual workarounds instead of the browser’s built-in tools | Passkey sign-in breaks or falls out of sync |
The security result stood out to me. Across Chrome’s whole test suite, the AI tools never added a Content Security Policy unless someone asked for one. Even when the prompt asked for security directly, they failed more than half of the security checks without the guidance. If you’re worried about this on your own site, my guide on how to keep your website secure after launch covers the basics.
How Modern Web Guidance works#
Modern Web Guidance works in the background, so you keep prompting your AI tool the same way you do now. Here’s what happens:
- You install it once into your AI coding tool.
- When the AI gets a web task, it searches the guides for the right one. The search runs on your own computer, with no API key.
- It loads that guide into its instructions: the modern way to build the feature, the common mistakes to avoid and a light fallback for older browsers.
- It writes the code, matched to the browsers your visitors use.
Version 1.0 also adds a modernisation workflow for older projects. It scans your HTML, CSS, JavaScript and package.json for outdated workarounds and libraries you no longer need, then guides the AI through safe upgrades. In this first release it only checks a limited set of known patterns, and Chrome plans to widen it over time.
A simple example: a pop-up window#
Ask an AI tool for a pop-up that closes when you click outside it, and without guidance it often writes a block of custom JavaScript. That code has to handle clicks, the Escape key, focus and screen readers by hand. With Modern Web Guidance, it uses the browser’s built-in dialog instead:
<button commandfor="my-popup" command="show-modal">Open</button>
<dialog id="my-popup" closedby="any">
<p>Thanks for your enquiry!</p>
<button commandfor="my-popup" command="close">Close</button>
</dialog>
That’s the whole pop-up. The browser handles the Escape key, clicks outside the box, keyboard focus and screen readers for you. Less code also means less to break when browsers update.
The same idea applies across many everyday features. Tooltips and dropdown menus can use the Popover API instead of a JavaScript library. FAQ accordions can use the details element. Page transitions and scroll effects can run in CSS instead of JavaScript.
What Modern Web Guidance means for your website#
If your website is built or updated with an AI coding tool, Modern Web Guidance should give you a better site for the same effort:
- Faster pages. Less JavaScript means quicker taps and fewer jumps while loading, which helps your Core Web Vitals scores. See why websites get slow for the bigger picture.
- A site more people can use. Keyboard users, screen reader users and people who turn off motion all get a working site.
- Fewer security gaps. Safer handling of user content, stronger security headers and passkey sign-in done properly.
- Fewer plugins and libraries. Every library you drop is one less thing to update or break.
- Better forms and checkouts. Correct autofill and error messages make forms quicker to fill in, especially on phones.
Chrome has shared some early results from teams using it:
| Company | How they used it | Result |
|---|---|---|
| note inc. (Japanese creator platform) | Alongside its own design system | Pass rate on modern web checks rose from 61% to 94% across 180 test runs |
| WeTV (Tencent’s streaming service) | With Chrome DevTools for agents, in its release pipeline | 90% of failed performance checks fixed automatically, with fix time down from 4 hours to 30 minutes |
| Pensionbazaar (Indian retirement platform) | To build and check new pages | Turnaround cut from about four days to a few hours, and over 90% fewer UI bugs on new screens |
| MetaMask (crypto wallet) | As an automatic reviewer on every code change | 43 fixes in five weeks, mostly accessibility, HTML and form issues |
These are Chrome’s own case studies, so treat them as best-case examples. Still, they point the same way as Chrome’s tests: AI-written code gets noticeably better with the right guidance.
One catch: it only helps when an AI coding tool writes your site’s code. If your site runs on Wix, Squarespace or a Shopify theme, you can’t add it, because you don’t control the code. For a business site you’ll keep for years, a custom front end with a WordPress back end gives you that control. It’s what I recommend for most clients, and I compare the options in my guide to the best website builder.
How to install Modern Web Guidance#
If you or your developer use an AI coding tool, setup takes about a minute. Run this from your project folder and the installer asks which tools to set up:
npx modern-web-guidance@latest install
In Claude Code, you can add it as a plugin instead:
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
It’s also in the plugin marketplaces for Codex, Cursor, Antigravity, GitHub Copilot, WebStorm, Kimi Code and Grok Build. If you installed the preview earlier in 2026, update to 1.0 with npx modern-web-guidance@latest update.
To check an existing project for outdated code, ask your agent:
/modern-web-guidance Modernize the code in this directory
One thing to know: the tool sends anonymous usage data to Google by default. That includes install counts, which guides were used and the search terms your AI tool sends, but not your own prompts. To turn it off, add export DISABLE_TELEMETRY=1 to your shell profile.
What Modern Web Guidance won’t do#
Modern Web Guidance makes AI-written code better, but it doesn’t replace checking the work. Keep these limits in mind:
- It doesn’t test your site. It guides the AI before it writes code. Someone still needs to check the result in real browsers and on real phones, which is why Chrome suggests pairing it with Chrome DevTools for agents.
- It isn’t an accessibility audit. Its automated checks cover a subset of accessibility rules, not the full WCAG standard.
- It won’t fix your content or SEO. A fast, accessible page still needs clear words, a strong offer and the right keywords.
- It can still be wrong. Review its changes like any other code. The modernisation scan is new and only covers a limited set of patterns so far.
If your site was built with Lovable, Bolt or a similar tool, my checklist of 7 things to check before you launch an AI-built website covers what to test by hand.
What it means for Australian businesses#
In Australia, website accessibility is more than good practice. The Disability Discrimination Act 1992 covers the goods and services you offer online, and in April 2025 the Australian Human Rights Commission updated its guidelines for digital services. Here’s what they say:
- The standard to meet: WCAG 2.2 at Level AA, as a minimum.
- What’s covered: websites (including online stores), apps, software as a service, AI-generated services and chatbots, plus sign-in steps like CAPTCHAs and two-factor checks.
- Their legal weight: the guidelines aren’t legally binding, but the Commission says following them helps you meet your obligations under the Act.
This isn’t new. The Commission first found an inaccessible website to be discrimination in 2000, in a complaint against the organisers of the Sydney Olympics.
Modern Web Guidance helps with several of the exact areas WCAG checks, like keyboard focus, form errors and reduced motion. But it isn’t a compliance check. If you sell online or take bookings in Australia, have a person test your key pages with a keyboard and a screen reader before launch. I work with businesses right across Australia and can do that check for you.
Common questions#
What is Modern Web Guidance?#
Modern Web Guidance is a free set of expert-written guides from Google Chrome that AI coding tools read while they work. It steers them toward modern browser features, so the websites they build are faster, more accessible and more secure.
Is Modern Web Guidance free?#
Yes. It’s free and open source under the Apache 2.0 licence. Chrome built it, and Firefox and Microsoft Edge now help maintain it.
Does Modern Web Guidance work with Claude?#
Yes. You can install it as a plugin in Claude Code, or with npx modern-web-guidance@latest install. It also works with Codex, Cursor, Antigravity, GitHub Copilot and several other coding tools.
Are AI-generated websites any good?#
They can be, but they usually need a review. AI-built sites tend to work on the surface while missing details in accessibility, speed and security. In Chrome’s tests, AI tools passed only about half of its best-practice checks without guidance.
Is AI-generated code safe?#
Not by default. Chrome found AI tools didn’t add a Content Security Policy unless asked, and failed more than half of its security checks even when the prompt asked for security. Have a developer review anything that handles logins, payments or customer data.
How can you tell if a website was vibe coded?#
From the outside it’s hard to be sure. Common signs include a generic look, pop-ups that don’t work with the keyboard and content that jumps while loading. My guide on what vibe coding is explains the term.
Will Modern Web Guidance help my SEO?#
Indirectly. Faster, more stable pages help your Core Web Vitals and give visitors a better experience. But it doesn’t write content or choose keywords, so it won’t replace an SEO plan. For more on that, read SEO vs AEO vs GEO.
How I can help#
Built your site with Lovable, Bolt, Claude Code or another AI tool? I can review the code, fix the accessibility, speed and security gaps, and set up Modern Web Guidance so future updates start from better code. If you’d rather start fresh, I’ll build you a fast custom website with a WordPress back end you can edit yourself.
Hire me on Fiverr and send me your site link. I’ll tell you honestly what’s worth fixing and what’s fine as it is.
Sources#
- Modern Web Guidance 1.0: The web platform expertise your coding agent is missing, Chrome for Developers, 10 November 2026
- Top 10 things AI gets wrong in web development, Chrome for Developers, 11 November 2026
- 15 updates from Google I/O 2026, Chrome for Developers, May 2026
- Modern Web Guidance on GitHub, README, install commands and telemetry details
- Modern Web Guidance eval dashboard, how the tests and accessibility checks work
- Guidelines on equal access to digital goods and services, Australian Human Rights Commission, April 2025
