How can I specify a branch/tag when adding a Git submodule?

by

Note: Git 1.8.2 added the possibility to track branches. See some of the answers below.

It’s a little confusing to get used to this, but submodules are not on a branch. They are, like you say, just a pointer to a particular commit of the submodule’s repository.

This means, when someone else checks out your repository, or pulls your code, and does git submodule update, the submodule is checked out to that particular commit.

This is great for a submodule that does not change often, because then everyone on the project can have the submodule at the same commit.

If you want to move the submodule to a particular tag:

cd submodule_directory
git checkout v1.0
cd ..
git add submodule_directory
git commit -m "moved submodule to v1.0"
git push

Then, another developer who wants to have submodule_directory changed to that tag, does this

git pull
git submodule update --init

git pull changes which commit their submodule directory points to. git submodule update actually merges in the new code.

More Related Contents:

  1. How to “git clone” including submodules?
  2. git submodule tracking latest
  3. How to change the remote repository for a git submodule?
  4. Git submodules in .gitmodules not initialized
  5. How do I pull from a Git repository through an HTTP proxy?
  6. How to un-submodule a Git submodule?
  7. How to make shallow git submodules?
  8. Two git repositories in one directory?
  9. Git submodule head ‘reference is not a tree’ error
  10. Pull latest changes for all git submodules
  11. List submodules in a Git repository
  12. how exactly does git submodule work
  13. How to set up a git project to use an external repo submodule?
  14. Git: can I suppress listing of ‘modified content’/dirty submodule entries in status, diff, etc?
  15. Git submodule to track remote branch
  16. Git submodule inside of a submodule (nested submodules)
  17. How to apply a git patch from one repository to another?
  18. How to only update specific git submodules?
  19. Git: track branch in submodule but commit in other submodule (possibly nested)
  20. Git submodule URL not including username?
  21. How do I move an existing Git submodule within a Git repository?
  22. How do I revert my changes to a git submodule?
  23. How do I manage conflicts with git submodules?
  24. Linking a single file from another git repository
  25. Nested git repositories without remotes (a.k.a. git submodule without remotes)
  26. Duplicate submodules with Git
  27. Highly coupled git submodules
  28. How to change a git submodule to point to a subfolder?
  29. Unable to track files within Git submodules
  30. Git update submodules recursively

Leave a Comment