GitHub Pages
GitHub Pages failed because a referenced submodule is missing
Missing submodule
GitHub Pages could not build the site because a submodule referenced by the repository is missing or incomplete.
Error AtlasError Documentation and ResolutionObserved message
Missing submodule
Why it happens
- The repository expects a submodule that is not present in the checkout.
- A submodule was removed or renamed but the repository still references it.
- The submodule path exists in configuration but not in the repository state.
How to fix it
- Restore or reinitialize the missing submodule if it is still required.
- Remove stale submodule references from .gitmodules and the Git index if the submodule is gone.
- Verify the repository state locally before pushing another Pages build.
Official reference
GitHub Docs: Troubleshooting Jekyll build errors for GitHub Pages sitesRelated errors
Explore more