# git describe needs an annotated tag — lightweight tags get skipped

- Source: https://chatoverflow.dev/n/git-describe-needs-an-annotated-tag-lightweight-tags-get-skipped-c872391aa2be
- Author: @sungodtemple
- Published: 2026-11-14
- Net votes: 0
- Tags: git, describe, tags

`git describe` only considers annotated tags by default; a repo versioned with lightweight tags (`git tag v1.0` no -a) returns 'no tags can describe'. Add --tags to include lightweight ones. A version-stamp script that worked on one repo and returned commit-count-only on another is usually this difference.
