renovate/docs/usage/semantic-commits.md

---
title: Semantic Commit messages
description: Configuring Renovate to use Semantic Commits
---

# Semantic Commit messages

To detect if your repository uses semantic commits, Renovate looks at the latest 10 commit messages in the base branch.
It then uses [conventional-commits-detector](https://github.com/conventional-changelog/conventional-commits-detector) to determine what convention the commit messages follow.

Renovate only detects Angular-style conventional commits, it ignores all other commit conventions.

When Renovate finds Angular-style commits, Renovate will create commit messages and PR titles that look like this:

- chore(deps): update eslint to v7.30.0
- fix(deps): update express to v4.17.1

Renovate uses the `chore` prefix by default.
When you extend `config:base`, Renovate still defaults to `chore`, but will use the `fix` prefix for npm production dependencies (`devDependencies` still use `chore`).

## Manually enabling or disabling semantic commits

You can override the default settings, and disable or enable semantic commits.

If you want Renovate to use semantic commits: add `":semanticCommits"` to your `extends` array.

If you want Renovate to stop using semantic commits, add `":semanticCommitsDisabled"` to your `extends` array.

## Changing the Semantic Commit type

You can change the Semantic Commit type that Renovate uses.

Say you want Renovate to use "chore" for every PR, you can add `":semanticCommitTypeAll(chore)"` to your `extends` array.
PR titles and commit messages start with "chore(deps):"

Or say you want to use "ci" for every PR, then you would add `":semanticCommitTypeAll(ci)"` to your `extends` array instead.
PR titles and commit messages start with "ci(deps):"

## Changing the Semantic Commit scope

If you don't like the default "deps" scope, you can use another word for the scope instead.
For example, to set the scope to "package" instead, add the preset `":semanticCommitScope(package)"` to your `extends` array.

If you want to _remove_ the semantic commit scope (e.g. use prefix `chore:` instead of `chore(deps):`), then add the preset `":semanticCommitScopeDisabled"` to your `extends` array.
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00			`---`
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`title: Semantic Commit messages`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00			`description: Configuring Renovate to use Semantic Commits`
			`---`

docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`# Semantic Commit messages`
docs: use mkdocs for website docs Closes #1661, Closes #1884, Closes #1909 2018-05-02 19:53:49 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`To detect if your repository uses semantic commits, Renovate looks at the latest 10 commit messages in the base branch.`
			`It then uses [conventional-commits-detector](https://github.com/conventional-changelog/conventional-commits-detector) to determine what convention the commit messages follow.`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`Renovate only detects Angular-style conventional commits, it ignores all other commit conventions.`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`When Renovate finds Angular-style commits, Renovate will create commit messages and PR titles that look like this:`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: update eslint and express version (#10786) 2021-07-12 09:36:12 +00:00			`- chore(deps): update eslint to v7.30.0`
			`- fix(deps): update express to v4.17.1`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: rewrite confusing sentences (#10269) 2021-06-02 10:07:09 +00:00			Renovate uses the `chore` prefix by default.
			When you extend `config:base`, Renovate still defaults to `chore`, but will use the `fix` prefix for npm production dependencies (`devDependencies` still use `chore`).
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
			`## Manually enabling or disabling semantic commits`

docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`You can override the default settings, and disable or enable semantic commits.`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			If you want Renovate to use semantic commits: add `":semanticCommits"` to your `extends` array.
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			If you want Renovate to stop using semantic commits, add `":semanticCommitsDisabled"` to your `extends` array.
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`## Changing the Semantic Commit type`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			`You can change the Semantic Commit type that Renovate uses.`
docs: add semantic commit deep dive to website 2017-12-28 04:57:01 +00:00
docs: improve the Semantic Commits message documentation (#8027) * reduce capitalization * full rewrite 2020-12-21 09:38:08 +00:00			Say you want Renovate to use "chore" for every PR, you can add `":semanticCommitTypeAll(chore)"` to your `extends` array.
			`PR titles and commit messages start with "chore(deps):"`

			Or say you want to use "ci" for every PR, then you would add `":semanticCommitTypeAll(ci)"` to your `extends` array instead.
			`PR titles and commit messages start with "ci(deps):"`

			`## Changing the Semantic Commit scope`

			`If you don't like the default "deps" scope, you can use another word for the scope instead.`
			For example, to set the scope to "package" instead, add the preset `":semanticCommitScope(package)"` to your `extends` array.

			If you want to _remove_ the semantic commit scope (e.g. use prefix `chore:` instead of `chore(deps):`), then add the preset `":semanticCommitScopeDisabled"` to your `extends` array.