Documentation

​
​

Development

User Acquisition

Monetization

Industry

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Build results
    • Check build results
    • Troubleshooting Build Automation failures
      • Troubleshoot common issues
      • Builds fail immediately
      • Unrecognized project error
      • Clone hangs when you use Git submodules
      • Lightmap baking
      • Android build failures
      • Errors after migration to a new Xcode version
      • macOS notarization failure
      • Problems with iOS Build Automation during XCode export
      • iOS build can't download or install from Unity Build Automation
  • Optimize build speed
  • Manage artifact retention rules
  • Manage concurrent builds
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  3. Build results

Troubleshoot Build Automation failures

Find and troubleshoot build errors, and learn how to resolve specific issues.
Read time 1 minute
Last updated 10 months ago
You can check the error logs to find and understand your build automation errors. Review common solutions to build errors, and refer to the following pages for more information about how to troubleshoot specific build errors.
Troubleshoot common issues
Solve common issues with Build Automation failures.
Builds cancel immediately upon start
Resolve issues with Unity Build Automation builds canceling immediately upon start.
Unrecognized project error
Resolve unrecognized project errors in Unity Build Automation and configure project paths correctly.
Clone hangs when you use Git submodules
Resolve issues with Git submodule clone steps hanging in Unity Build Automation.
Unity Build Automation lightmap baking
Resolve Unity Build Automation lightmap baking issues and understand common causes and solutions.
Android build fails in Unity Build Automation
Resolve Android build failures in Unity Build Automation and identify common causes.
Errors after migration to a new Xcode version
Resolve errors caused by migrating to a new Xcode version.
OSX notarization failure
Resolve macOS notarization failures and fix signing issues.
Problems with iOS Build Automation during XCode export
Resolve iOS build automation problems during Xcode export in Unity Build Automation.
iOS build can't download or install from Unity Build Automation
Resolve iOS build download and installation issues in Unity Build Automation.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

    Report a problem with this page