Vercel shows “404: NOT_FOUND” on your deployed site

Find your cause

5 causes, most likely first

1. 1

   The Framework Preset is wrong, or set to Other

   How to tell: Every page gives 404, though the build log looks fine.

   Fix

   Pick your framework in the settings below, then redeploy.

   Settings→Build and Deployment→Framework Settings

2. 2

   The Output Directory doesn't match the build

   How to tell: The deployment's Output tab doesn't show your index.html.

   Fix

   Set Output Directory to the folder your build creates (dist, build, out, public), then redeploy.

3. 3

   A single-page app without a rewrite

   How to tell: The home page works; refreshes and direct links fail.

   Fix

   Add a vercel.json at the repository root and commit it:

   {
     "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
   }

4. 4

   The project is in a subfolder of the repository

   How to tell: Your repository holds more than one project.

   Fix

   Set Root Directory to the project's folder in the same build settings.

5. 5

   Only your own domain gives the 404

   How to tell: The .vercel.app address works; your domain doesn't.

   Fix

   Then it's the domain, not the build: check the DNS records and remove old ones from a previous host.

Questions

Also asked