Configure & deploy site /Site deploys /

Fix a failed deploy

Netlify’s AI capabilities help diagnose and suggest solutions for deploy failures or build errors so you can get back to shipping code.

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

# How these solution suggestions work

When a deployment failure happens, your team will find a Why did it fail? button on the failed deploy summary page. This button always appears on failed deploys unless an Owner has disabled the feature for your team.

If this feature is enabled for your team and you select the Why did it fail? button, the details about the failure are processed by Netlify’s AI systems to generate guidance for how to resolve the issue.

We’re continuously improving the feature to suggest accurate solutions but your team should review them for accuracy.

# Security for solution suggestions

This feature does not use the information processed to train models or store data outside of Netlify’s systems.

The deploy failure details used to generate suggestions includes:

  • a subsection of the build log entries in your deploy log at or around the place where the error returns.
  • other metadata, such as the name of your site’s framework to provide more accurate results.

Like all Netlify features, usage of this capability is subject to our service agreements referenced in the Terms of Use.

# Enable solution suggestions

These AI capabilities are only available if they have been enabled for your team. Once enabled, any Developer or Owner on your team can use this AI capability to generate solutions for resolving deploy failures on all sites they have access to in your team.

Who can turn this feature on or off:

  • Owners can enable or disable this feature for their team.
  • Developers can enable this feature for their team unless an Owner has disabled this feature for the team. The Why did it fail? button appears to Developers and Owners unless the feature is disabled.
    • If a Developer selects the Why did it fail? button and the feature is not enabled or disabled for the team, then a prompt appears to enable this feature for the team. Until this feature is enabled on the team, selecting this button will not process the deploy failure details or generate suggestions.

As an Owner, to enable deploy failure solution suggestions:

  1. For your team, go to
  2. Select Configure.
  3. Choose Enabled.

# Disable solution suggestions

Once disabled, the Why did it fail? button will not appear on any of your team’s sites. Only an Owner can enable deploy diagnostics for all sites in your team after the feature is disabled.

As an Owner, to disable deploy failure solution suggestions:

  1. For your team, go to
  2. Select Configure.
  3. Choose Disabled.

# More troubleshooting help