diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2bbcedc..9f03f49 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,54 @@
+### Changelog
+
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
+
+#### [Unreleased](https://github.com/metalsmith/permalinks/compare/v2.3.0...HEAD)
+
+- Resolves #122: remove deprecated substitute pkg, add regexparam instead [`#122`](https://github.com/metalsmith/permalinks/issues/122)
+- Fixes #120: default linkset options should be overwritten by other linksets [`#120`](https://github.com/metalsmith/permalinks/issues/120)
+- Resolves #121: Align dot & repo files with core plugins [`#121`](https://github.com/metalsmith/permalinks/issues/121)
+- Update debug to 4.3.3, moment to 2.29.1, slugify to 1.6.4 [`4360a30`](https://github.com/metalsmith/permalinks/commit/4360a30a9cfceb6a7804f4236883397d01b29d4e)
+- feat: proper jsdocs, cleaner option handling code [`4684767`](https://github.com/metalsmith/permalinks/commit/46847676316eb11bbdea59b7431054b71683b4e2)
+- feat: allow optional pattern placeholder [`a7f89ea`](https://github.com/metalsmith/permalinks/commit/a7f89eac814b74f481ced70748f877f6167415d4)
+- fix: remove console.log typo, fix few README typo's [`2ea03de`](https://github.com/metalsmith/permalinks/commit/2ea03de60b354a2e9f5017c583f57a024014d368)
+- Update slugify 1.6.4 -> 1.6.5 [`13e3dbf`](https://github.com/metalsmith/permalinks/commit/13e3dbf1bd4963236bf4eae910d28901d40b52cd)
+- chore: fix typo in package.json [`dd8ec97`](https://github.com/metalsmith/permalinks/commit/dd8ec977c969f1eceefb87c91a18a210977a589c)
+- Fixes debug channel to '@metalsmith/permalinks' [`21bc858`](https://github.com/metalsmith/permalinks/commit/21bc858b2e245ffe9ff2a803139d0750b1e00fed)
+
+#### [v2.3.0](https://github.com/metalsmith/permalinks/compare/v2.1.0...v2.3.0)
+
+> 29 May 2021
+
+- ES6-ify codebase. [`4626521`](https://github.com/metalsmith/permalinks/commit/46265217f2796091d61165756e3ada5f7e0d725d)
+- Added ability to extend slugify; Docs added [`e9edcbd`](https://github.com/metalsmith/permalinks/commit/e9edcbd74506f4c2ab0320d1f8b8b464db3ec58a)
+- Improve docs on slug options, see #2 [`bd10c17`](https://github.com/metalsmith/permalinks/commit/bd10c17b2b92cc563744d752355db72f1b9dd144)
+- GH workflow: only run lint on 1 OS [`59938fb`](https://github.com/metalsmith/permalinks/commit/59938fbee8e29283b3ef5b77d9707f84009d42f3)
+- Switch to xo + prettier. [`6d12908`](https://github.com/metalsmith/permalinks/commit/6d12908413967d233635ac158b4c93fa98c8ff76)
+- Switch to GitHub Actions CI [`b910096`](https://github.com/metalsmith/permalinks/commit/b910096ebb6adf807c9a818ad4f4e35d067c41a4)
+- Update Readme.md, xo dependency to latest version [`6303701`](https://github.com/metalsmith/permalinks/commit/6303701b82373cad7e05efc92be30d33696f81fc)
+- Update dependencies. [`3269f79`](https://github.com/metalsmith/permalinks/commit/3269f79d37a6e630a560f028bc76fdf9d976b684)
+- Packages updated: transliteration api changed - fixtures updated accordingly [`c74449b`](https://github.com/metalsmith/permalinks/commit/c74449b14f6a112afcdf265498e05265fad70a93)
+- Update & apply linting rules to be mostly backwards-compatible [`c945a0d`](https://github.com/metalsmith/permalinks/commit/c945a0dfb51d929058dc77c7c448ea97c09dc8b2)
+- Update package.json with new repo location, NPM scope [`1b9ba66`](https://github.com/metalsmith/permalinks/commit/1b9ba6680a12701b9ac0ae6e13b334af8535f9da)
+- Use https. [`9f0db0d`](https://github.com/metalsmith/permalinks/commit/9f0db0d399c75e541a45e7468c4b5baaafcc2482)
+- Update rimraf, nodemon, slugify, moment to latest, tweak npm scripts [`da4cd29`](https://github.com/metalsmith/permalinks/commit/da4cd293e245b3418c58adbf93f8ac710b814a52)
+- package.json: don't run `lint --fix` on CI. [`857dd11`](https://github.com/metalsmith/permalinks/commit/857dd11d6249dd706cca0c312d919e90257b9d74)
+- Update Travis CI config. [`6557cb9`](https://github.com/metalsmith/permalinks/commit/6557cb96fcce6f7cd8316a3053373d935f656a9a)
+- Update slugify/ transliteration to latest, update tests & Node version support [`ed687c0`](https://github.com/metalsmith/permalinks/commit/ed687c0001f562c32ce916cd42ee437f782a9d0d)
+- Align node version testing with LTS EOL [`5d29e0d`](https://github.com/metalsmith/permalinks/commit/5d29e0deb70d98473a6fa8cbc7196a02503a058b)
+- Adhere to the new lint rules. [`4dcd78b`](https://github.com/metalsmith/permalinks/commit/4dcd78bd14d1f2346965defc39f6f69de59d78f2)
+- Make permalinks a named plugin (for debugging), fix incorrect ref in makeUnique function [`b318e7c`](https://github.com/metalsmith/permalinks/commit/b318e7ce09df153a7470859e3dab466b2ff17d0b)
+- package.json: add an engines property >= 6 [`6974b9c`](https://github.com/metalsmith/permalinks/commit/6974b9c79f6e84b89f34b93a1b7baa022cc515fe)
+- Attempt to fix the last Windows failure. [`6088c69`](https://github.com/metalsmith/permalinks/commit/6088c690c3960edeee3001e4675061eb656055ba)
+- Fix one Windows test failure [`9e5e1f6`](https://github.com/metalsmith/permalinks/commit/9e5e1f6d0dc7b1844ca2fecbca3729b97ed7f90e)
+- Fix backslashes on Windows [`6977b3e`](https://github.com/metalsmith/permalinks/commit/6977b3e710728a18fca3cdc1f5e999713e64ed01)
+- Update Github workflow (xo compat node >= 10) [`19d55b2`](https://github.com/metalsmith/permalinks/commit/19d55b2880c475ad417a1a0046a7105413fac2ef)
+- Update nodemon npm script [`3d83ce7`](https://github.com/metalsmith/permalinks/commit/3d83ce7956f48635a3b3e59362c55fb6d4fefd0d)
+- Enforce LF. [`0b6a8c9`](https://github.com/metalsmith/permalinks/commit/0b6a8c9d582c011599cfb49114da8bdddaeaffac)
+- Properly disable package-lock.json. [`aded406`](https://github.com/metalsmith/permalinks/commit/aded4069703dd6016993c0e2e51b7266da742332)
+
 <!-- auto-changelog-above -->
 
 ## [2.2.0][] - 2019-02-21