Sentry Commit Messages
Follow these conventions when creating commits for Sentry projects.
Format
The header is required. Scope is optional. All lines must stay under 100 characters.
Commit Types
Subject Line Rules
- Use imperative, present tense: "Add feature" not "Added feature"
- Capitalize the first letter
- No period at the end
- Maximum 70 characters
Body Guidelines
- Explain what and why, not how
- Use imperative mood and present tense
- Include motivation for the change
- Contrast with previous behavior when relevant
Footer: Issue References
Reference issues in the footer using these patterns:
Fixescloses the issue when mergedRefslinks without closing
Examples
Simple fix
Feature with scope
Refactor
Breaking change
Revert Format
Principles
- Each commit should be a single, stable change
- Commits should be independently reviewable
- The repository should be in a working state after each commit


