Netlify Not Working? Common Errors & Fixes
The 10 Netlify problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Netlify Page Not Found on Refresh (SPA 404)
Fixed in latest versionWeb, CLIClient-side routes (React Router, Vue Router) 404 on refresh because Netlify looks for a real file. Add a /* /index.html 200 rewrite as a _redirects file in your publish directory.
Netlify Build Failed
Workaround availableWeb, CLIMost Netlify build failures come from dependency or version mismatches. Match Node versions, commit your lockfile, fix case-sensitive filenames and retry without cache.
Netlify Deploy Stuck on Building or Enqueued
OngoingWeb, CLIA deploy stuck on Building or Enqueued: Awaiting Capacity usually blocks the queue. Cancel the active build, retry, or send Netlify support the deploy link.
Netlify Custom Domain Not Working
Fixed in latest versionWeb, CLIA custom domain fails when DNS does not point at Netlify, a proxy intercepts traffic, or DNSSEC blocks validation. Check records with dig, then renew the certificate.
Netlify SSL Certificate Pending or Not Provisioning
Workaround availableWeb, CLINetlify issues certificates through Let's Encrypt only after DNS points to Netlify. Fix DNS, CAA records and proxies, then use Renew certificate under Domain management > HTTPS.
Netlify Function Timeout (502 / 504)
Workaround availableWeb, CLISynchronous Netlify functions stop after 60 seconds and buffered responses max out at 6 MB. Move long work to a background function (15 minutes) or split it up.
Netlify Site Paused: Credit Limit Reached
Workaround availableWeb, CLIWhen credits run out all team projects pause and show 'Site not available'. Upgrade, buy a credit pack, enable auto recharge, or wait for the next billing cycle.
Netlify Build Failed: Secrets Scanning Detected Secrets
Workaround availableWeb, CLINetlify can fail a build when a secret value appears in the output or deployed files. Remove the secret from the bundle, or omit specific keys via SECRETS_SCAN_OMIT_KEYS.
Netlify Environment Variables Undefined
Fixed in latest versionWeb, CLIVariables must have the Builds scope and be exposed to your framework. Build-time values are not available at runtime unless embedded or read from a function.
How to Cancel Netlify Subscription
Fixed in latest versionWeb, CLIDowngrade to Free under Usage & billing > Plan details > Change team plan (Team Owner only). It takes effect at the next billing cycle. To stop everything, delete the team or account.
Problem not listed? See all Netlify complaints or compare Netlify alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like Netlify: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code