Netlify "Page not found" when refreshing or opening a link

Netlify shows "Page not found" on refresh or deep links? Add the /* /index.html 200 rewrite so your single-page app handles routing.

Reviewed October 14, 2026

What it means in plain English

Same cause as on Vercel: your app is a single HTML page that handles routes in the browser, but Netlify looks for a real file at each path.

Likely causes

  • No _redirects file or netlify.toml redirect.
  • The _redirects file isn't in the published folder (e.g. it's not copied into dist).

How to fix it, step by step

  1. Create public/_redirects (Vite copies public/ into dist/) containing:
/*  /index.html  200
  1. Or in netlify.toml:
[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200
  1. Make this the last rule if you have others. Real files still win, so assets keep loading.
  2. Commit and redeploy.

How to check it worked

  • Open a deep link directly and refresh; it should load.
  • In the deploy summary, Netlify should list 1+ redirect rules processed.

Sources

Can't fix it? Get help.

If the steps didn't clear the error, send what the screen says. A person can take a look. This is a request for a paid fix, not an instant chat.

Request a fix