Skip to content
Learn Measure Blog Case studies About
On this page
  • How the Lighthouse start_url audit fails
  • How to ensure your page is available offline
  • Resources

start_url does not respond with a 200 when offline

May 4, 2019 — Updated Apr 29, 2020
Available in: Español, Português, English
Appears in: PWA audits
On this page
  • How the Lighthouse start_url audit fails
  • How to ensure your page is available offline
  • Resources

The manifest for a Progressive Web App (PWA) should include a start_url, which indicates the URL to be loaded when the user launches the app.

If the browser doesn't receive an HTTP 200 response when accessing an app from the start_url, either the start_url isn't correct, or the page isn't accessible offline. This causes problems for users who have installed the app to their devices.

How the Lighthouse start_url audit fails #

Lighthouse flags web apps whose start URL doesn't respond with a 200 when offline:

Lighthouse audit showing start URL doesn't respond with 200 when offline
In the Lighthouse report UI the full PWA badge is given when you pass all of the audits in all of the PWA subcategories (Fast and reliable, Installable, and PWA optimized).

How to ensure your page is available offline #

Success

Workbox is the recommended approach for adding service workers to websites because it automates a lot of boilerplate, makes it easier to follow best practices, and prevents subtle bugs that are common when using the low-level ServiceWorker API directly.
  1. If you don't already have one, add a web app manifest.
  2. Check that the start_url in your manifest is correct.
  3. Add a service worker to your app.
  4. Use the service worker to cache files locally.
  5. When offline, use the service worker as a network proxy to return the locally cached version of the file.

See the Current page does not respond with a 200 when offline guide for more information.

Resources #

  • What is network reliability and how do you measure it?
  • Add a web app manifest
  • Workbox: Your high-level service worker toolkit
Last updated: Apr 29, 2020 — Improve article
Return to all articles
Share
subscribe

Contribute

  • File a bug
  • View source

Related content

  • developer.chrome.com
  • Chrome updates
  • Web Fundamentals
  • Case studies
  • Podcasts
  • Shows

Connect

  • Twitter
  • YouTube
  • Google Developers
  • Chrome
  • Firebase
  • Google Cloud Platform
  • All products
  • Terms & Privacy
  • Community Guidelines

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies.