Skip to content

Troubleshooting

Get help with common issues and learn best practices for requesting more support.

I need help with …Go to …
Changing my project name on NetlifyChanging project name
Getting my site to run locallyCheck out your framework docs or Netlify’s Local development guide or Framework setup guides
Missing filesDeploy File Explorer
404 Page not foundSupport Guide: Page not found
build failed with non-zero exit codeSupport Guide:Build troubleshooting tips
Understanding my build logSupport Guide: Build log overview
DNSDomains troubleshooting
FormsForms troubleshooting
BillingBilling FAQs or you can reach out directly to Support
Logging inSupport Guide: Troubleshooting logging in
Error linking repo when creating a new site: Looks like something went wrong!Support Guide: Error linking repo when creating a new site

To check for missing file, use Netlify’s Deploy File Explorer.

Using Netlify’s Deploy File Explorer, you can:

  • Navigate your build output like a file system.
  • Download only the files you need.
  • Use substring search to quickly find specific resources.
  • Download the entire output as a single zip file from any successful deploy.
Page not found
Looks like you’ve followed a broken link or entered a URL that doesn’t exist on this site.
If this is your site, and you weren’t expecting a 404 for this path, please visit Netlify’s “page not found” support guide for troubleshooting tips.

If your site unexpectedly serves a 404 page error, there can be several reasons why. For instance, if your geographic area or IP address is blocked from a site, then you will only see a Netlify-branded 404 page.

For more possibilities and troubleshooting help, check out our verified Support Forums guide on unexpected 404 page errors.

Learn best practices for avoiding build failures, how to avoid build failures, and the top causes of build failures from our verified Netlify Support Guide.

To change your project name, go to Project configuration General Project details Project information and choose Manage project name and thumbnail.

To help you fix failed deploys, Netlify offers AI capabilities that diagnose and suggest solutions for deploy failures and build errors so you can get back to shipping code.

Learn more about Netlify’s AI capabilities to give solutions for failed deploys.

A failed deploy with a "Why did it fail?" button and a diagnosis and suggested solution above the deploy log details

This feature is available on Pro and Enterprise plans.

Providing specific, detailed information in your initial request may help reduce back-and-forth so we can resolve your issue together, faster. This section provides tips to help you prepare to send a request through the support form at netlify.com/support.

You can find this information under Project configuration General Project details Project information Project name. Other places in the Netlify UI may list your project by its custom domain if you’ve configured one, so be sure to send us the Project name from this location.

Project name is also known as the site name.

If your request pertains to multiple projects, please share all relevant project names.

If your request isn’t about a specific project, please enter n/a for the project name. Questions that aren’t about a specific project are often about a user account or team account. If that’s the case, please provide the email address for your user or account slug for your team as described below.

If you have multiple email addresses, be sure to use the one that’s associated with the user, project, or team that you need help with. This ensures your request will be prioritized as entitled by your subscription.

If your question pertains to a team rather than a project or user, please provide the team’s account slug in the body of your request. You can find this information under Team settings > General > Team details > Team information > Slug.

You can’t send screenshots through the support form, but you can add them after you’ve submitted your request. After you submit the form, you’ll get an email confirming that our help desk has received your request. You can send relevant screenshots in response to the email.