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
  5. Troubleshoot Build Automation failures

Clone hangs when you use Git submodules

Resolve issues with Git submodule clone steps hanging in Unity Build Automation.
Read time 1 minute
Last updated 10 months ago

Symptom

You configured your project to use Git submodules, but the clone step hangs.

Resolution

To stop the clone step from hanging, verify that you configured your submodules to use either the relative path or the SSH path to the submodule.

Additional resource

For an example of how to use relative paths, refer to this Stack overflow post.
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.

  • On this page

    • Symptom

    • Resolution

    • Additional resource

Report a problem with this page