# conventional-changelog-eslint

> ESLint preset for conventional-changelog.

Latest version **6.1.0** (published 2026-03-04) · ISC license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install conventional-changelog-eslint
pnpm add conventional-changelog-eslint
yarn add conventional-changelog-eslint
bun add conventional-changelog-eslint
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 6.1.0 |
| Published | 2026-03-04 |
| First published | 2015-12-26 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 0 |
| Unpacked size | 7.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8506 |
| Author | Steve Mao |
| Maintainers | bcoe, oss-bot, dangreen, stevemao, tapppi |
| Keywords | conventional-changelog, eslint, preset |

## Links

- npm: https://www.npmjs.com/package/conventional-changelog-eslint
- Repository: https://github.com/conventional-changelog/conventional-changelog
- Homepage: https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-eslint#readme
- Issues: https://github.com/conventional-changelog/conventional-changelog/issues
- npm.io page: https://npm.io/package/conventional-changelog-eslint

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 6.1.0 (latest) — 2026-03-04
- 3.0.9 (next) — 2020-11-05
- 6.0.0 — 2024-05-03
- 5.0.0 — 2023-08-27
- 4.0.0 — 2023-06-06
- 3.0.8 — 2020-05-08
- 3.0.4 — 2019-10-03
- 3.0.2 — 2019-04-10
- 3.0.1 — 2018-11-01
- 3.0.0 — 2018-06-06
- 2.0.0 — 2018-05-29
- 1.0.9 — 2018-03-28
- 1.0.8 — 2018-03-27
- 1.0.7 — 2018-03-27
- 1.0.6 — 2018-03-22
- … 11 more at https://npm.io/package/conventional-changelog-eslint/versions

## README

# conventional-changelog-eslint

[![ESM-only package][package]][package-url]
[![NPM version][npm]][npm-url]
[![Node version][node]][node-url]
[![Dependencies status][deps]][deps-url]
[![Install size][size]][size-url]
[![Build status][build]][build-url]
[![Coverage status][coverage]][coverage-url]

[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
[package-url]: https://nodejs.org/api/esm.html

[npm]: https://img.shields.io/npm/v/conventional-changelog-eslint.svg
[npm-url]: https://npmjs.com/package/conventional-changelog-eslint

[node]: https://img.shields.io/node/v/conventional-changelog-eslint.svg
[node-url]: https://nodejs.org

[deps]: https://img.shields.io/librariesio/release/npm/conventional-changelog-eslint
[deps-url]: https://libraries.io/npm/conventional-changelog-eslint

[size]: https://packagephobia.com/badge?p=conventional-changelog-eslint
[size-url]: https://packagephobia.com/result?p=conventional-changelog-eslint

[build]: https://img.shields.io/github/actions/workflow/status/conventional-changelog/conventional-changelog/tests.yaml?branch=master
[build-url]: https://github.com/conventional-changelog/conventional-changelog/actions

[coverage]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master

[conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) [eslint](https://github.com/eslint/eslint) preset.

**Issues with the convention itself should be reported on the ESLint issue tracker.**

## Install

```bash
# yarn
yarn add -D conventional-changelog-eslint
# pnpm
pnpm add -D conventional-changelog-eslint
# npm
npm i -D conventional-changelog-eslint
```

## ESLint Convention

Our commit message format is as follows:

```
Tag: Short description (fixes #1234)

Longer description here if necessary
```

The first line of the commit message (the summary) must have a specific format. This format is checked by our build tools.

The `Tag` is one of the following:

* `Fix` - for a bug fix.
* `Update` - either for a backwards-compatible enhancement or for a rule change that adds reported problems.
* `New` - implemented a new feature.
* `Breaking` - for a backwards-incompatible enhancement or feature.
* `Docs` - changes to documentation only.
* `Build` - changes to build process only.
* `Upgrade` - for a dependency upgrade.
* `Chore` - for refactoring, adding tests, etc. (anything that isn't user-facing).

Use the [labels of the issue you are working on](working-on-issues.md#issue-labels) to determine the best tag.

The message summary should be a one-sentence description of the change, and it must be 72 characters in length or shorter. If the pull request addresses an issue, then the issue number should be mentioned at the end. If the commit doesn't completely fix the issue, then use `(refs #1234)` instead of `(fixes #1234)`.

Here are some good commit message summary examples:

```
Build: Update Travis to only test Node 0.10 (refs #734)
Fix: Semi rule incorrectly flagging extra semicolon (fixes #840)
Upgrade: Esprima to 1.2, switch to using comment attachment (fixes #730)
```

The commit message format is important because these messages are used to create a changelog for each release. The tag and issue number help to create more consistent and useful changelogs.

Based on https://eslint.org/docs/developer-guide/contributing/pull-requests#step2

---
_Source: https://npm.io/package/conventional-changelog-eslint · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._