webdev-resources

Conventional Commit Types for Git

Last Updated: 04 JUN 2025


Conventional Commits are a standardized way to structure Git commit messages. This helps with clarity, changelogs, automation, and collaboration.

Common Commit Types

Prefix Purpose
feat: A new feature — adds user-facing functionality
fix: A bug fix — resolves a defect or issue
chore: Routine maintenance — setup, tooling, configs, no user impact
docs: Documentation changes only (e.g. README, inline comments)
style: Code style changes (spacing, semicolons, formatting, etc)
refactor: Code changes that restructure but don’t alter behavior
perf: Performance improvements
test: Add or update tests (unit, integration, etc.)
build: Build system or dependency changes (npm, composer, Webpack, etc.)
ci: Continuous Integration changes (GitHub Actions, CircleCI, etc.)
revert: Revert a previous commit

Example Commit Messages

feat: add new daily planner template

fix: resolve template rendering issue in Oxygen

docs: update README with setup instructions

chore: add .gitignore and remove tracked system files

refactor: split utility functions into separate modules

test: add snapshot tests for PDF export module

build: update Webpack config for production optimization

ci: add GitHub Actions workflow for plugin deployment

revert: revert "feat: add color picker to product editor"

Using Scopes (Optional)

You can clarify what part of the codebase you’re working on by adding a scope:

feat(planner): add customizable weekly spread

chore(deps): update WooCommerce plugin to v8.2

fix(styles): correct margin issues on mobile layout

Best Practices