Home›Hosting›Guide

Netlify 404 Page Not Found: Troubleshooting Checklist

Learn the difference between a broken deploy, a broken link and a wrong custom-domain assignment.

Quick answer

Learn the difference between a broken deploy, a broken link and a wrong custom-domain assignment.

Step-by-step instructions

  1. Step 01

    Open the netlify.app project URL; if that also 404s, focus on deployment first.

  2. Step 02

    Check that the published folder contains index.html and that the deployment is marked successful.

  3. Step 03

    If the root works but a specific link does not, verify the file path, capitalization and extension.

  4. Step 04

    If /index.html works but / fails, inspect publication settings and any redirect configuration.

  5. Step 05

    If the netlify.app URL works but the custom domain 404s, confirm the custom domain is assigned to this exact Netlify project.

  6. Step 06

    Check DNS record targets for apex and www, including whether a second project accidentally claimed the domain.

  7. Step 07

    Wait for DNS propagation; do not create duplicate projects just to fix a DNS problem.

  8. Step 08

    Test in private mode and check Netlify domain diagnostics and deployment logs.

Before you finish: important checks

  • Do not assume a Google Ads campaign changed your domain routing; DNS/deployment determines where it points.

Common problems and fixes

  • Homepage correct only in incognito? Clear cache or check service-worker caching.
  • Only custom domain wrong? Verify domain assignment and DNS targets, not just source files.

Frequently asked questions

Do I have to repurchase domain?

No, not to correct a typical 404 configuration error.

Keep this in mind

WordPress, hosting and AI interfaces change. Check the service's current documentation before changing billing, domain DNS, security or important site settings. Rayhan Studio publishes educational help, not guaranteed results.