Need AI Training/Help?CloudYeti.io/meet
MarkdownMe
Developer commit guide

Which Conventional Commit Type Should I Use?

Choose the right Conventional Commit type for feat, fix, docs, refactor, perf, test, build, ci, chore, and revert commits.

Direct answer

Choose the Conventional Commit type from the user-visible effect first, then the files changed. Use feat when the user gets a new capability, fix when broken behavior is restored, docs for documentation-only changes, refactor when behavior stays the same, perf when the same behavior is faster, test for test-only changes, ci for workflow changes, build for dependencies or build tooling, chore for maintenance, and revert when undoing a prior commit.

Open Conventional Commit Generator

When to use this

  • You know what changed but are unsure whether it is feat, fix, chore, refactor, or docs.
  • The files changed do not match the effect, such as a bug fix inside refactored code.
  • You want commitlint and semantic-release to interpret the change correctly.

Steps

  1. Describe what changed in plain English.
  2. Name the user-visible or release-visible effect.
  3. Pick the type from that effect instead of the folder changed.
  4. Add a short lowercase scope if one area is clearly affected.
  5. Generate the final subject and review it before committing.

Example

Change context
Changed the login form and AuthService so users are sent back to the page they originally requested after signing in. Added a regression test.
Commit message
fix(auth): preserve redirect target after login

Common mistakes

  • Do not use refactor for a bug fix just because implementation files were reorganized.
  • Do not use chore for user-facing behavior changes.
  • Do not invent a type unless your commitlint config allows it.

FAQ

Should I choose the type by file changed or behavior changed?
Choose by behavior changed. A fix in a UI file is still fix, and a docs-only change in a source folder is still docs.
When should I use chore?
Use chore for maintenance that does not change runtime behavior, docs, tests, build tooling, or CI in a way covered by a more specific type.
Is refactor a release change?
Usually no. Refactor means the code changed internally while behavior stayed the same, so release automation normally does not publish a version from it.

Related Conventional Commit guides

Fix a Commitlint Conventional Commit Failure

Rewrite failed commitlint subjects into valid Conventional Commit messages with the right type, scope, subject, and breaking-change footer.

Semantic Release Conventional Commit Version Bump

Use Conventional Commits to signal patch, minor, and major releases for semantic-release, release-please, changesets, and similar tooling.

AI Coding Session Commit Message Generator

Turn a Claude Code, Codex, Cursor, Copilot, or Windsurf coding session summary into one clean Conventional Commit message.

Desk gear for long writing sessions

A few things that help if you write docs, tickets, and specs on a laptop all day.

Dock

Anker 5-in-1 USB-C Hub

One cable turns a laptop into a desk setup. Drives a 4K display, charges at up to 85W, and adds three data ports.

  • 4K HDMI output
  • 85W max power delivery
  • 1x USB-C + 2x USB-A, 5Gbps each
  • MacBook Pro, MacBook Air, Dell
Check price on Amazon →Monitor · I use this

Dell 27" S2725QC 4K

The monitor I write and review documents on. 163 PPI keeps small text sharp, and USB-C carries video and power on one cable.

  • 3840x2160 IPS, 163 PPI
  • 120Hz, 4ms, FreeSync Premium
  • 99% sRGB
  • USB-C, HDMI, DisplayPort
Check price on Amazon →Laptop

Apple MacBook Neo 13" (A18 Pro)

The cheapest way into an Apple-silicon machine that runs local models. Fanless, and the Liquid Retina panel holds small text at a full day of reading.

  • A18 Pro chip, built for Apple Intelligence
  • 8GB unified memory, 256GB SSD
  • 13-inch Liquid Retina display
  • 1080p FaceTime HD camera
Check price on Amazon →

Amazon affiliate links. We earn a commission on qualifying purchases at no extra cost to you.