diff --git a/CHANGELOG.md b/CHANGELOG.md
index c87264d..9a0d037 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,8 +4,27 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v2.5.0](https://github.com/metalsmith/permalinks/compare/v2.4.1...v2.5.0)
+
+- Resolves #134: deprecates & merges options 'duplicatesFail' & 'unique' into new option 'duplicates' [`#134`](https://github.com/metalsmith/permalinks/issues/134)
+- Fixes #48, aligns linkset & default options date & slug formatting [`#48`](https://github.com/metalsmith/permalinks/issues/48)
+- Resolves #44: eliminate ambiguity with setImmediate(done) [`#44`](https://github.com/metalsmith/permalinks/issues/44)
+- Resolves #129: provides dual ESM/CJS module [`#129`](https://github.com/metalsmith/permalinks/issues/129)
+- Drops support for Metalsmith < 2.5.0, replaces debug with metalsmith.debug [`7e1c0dc`](https://github.com/metalsmith/permalinks/commit/7e1c0dc8707f9cef4e44b42fe808715a37a00434)
+- Deprecates file.path in favor of file.permalink and adds better testing [`c7a56f1`](https://github.com/metalsmith/permalinks/commit/c7a56f145e18d7c49885fd42a34ee14760417ed2)
+- Adds Typescript definitions [`6354c95`](https://github.com/metalsmith/permalinks/commit/6354c95d90e568985679ef67a452bedf5e71a7f4)
+- Aligns behavior of using alt indexFile and adds indexFile test [`5d6d861`](https://github.com/metalsmith/permalinks/commit/5d6d8618645bbe79d38493a6dc4de446d67e504b)
+- Deprecates the file.path property in favor of file.permalink [`4130e03`](https://github.com/metalsmith/permalinks/commit/4130e03e157b449b2c9ea688ff1804e44335a7a7)
+- Deprecates options.indexFile in favor of options.directoryIndex [`b6ee083`](https://github.com/metalsmith/permalinks/commit/b6ee08354f7b1ed0e23f07c5255af02c56ff1b77)
+- test: add test case for array matches & cheat coverage [`5f7734c`](https://github.com/metalsmith/permalinks/commit/5f7734c0c0c2e63bb613572a4ce2412b721dcc66)
+- docs: correct typo's & omissions in README.md [`94816a2`](https://github.com/metalsmith/permalinks/commit/94816a2ce45696a24b750265bd0013be9294eeee)
+- Deprecates the 'relative' option, cfr. #132 [`ffb7fcb`](https://github.com/metalsmith/permalinks/commit/ffb7fcb41a41259b47856959d73c8e705ae6679f)
+- fix: ESM build export * instead of default from regexparam [`e1a9fe6`](https://github.com/metalsmith/permalinks/commit/e1a9fe6684743429741c15148345eb7a43bf7105)
+
 #### [v2.4.1](https://github.com/metalsmith/permalinks/compare/v2.4.0...v2.4.1)
 
+> 31 October 2022
+
 - Updates regexparam 2.0.0 -> 2.0.1, debug 4.3.3 -> 4.3.4 [`309e998`](https://github.com/metalsmith/permalinks/commit/309e9985c9b2f699c64a878cbd61c412937d843b)
 - Dropped support for Node < 12 [`ec20c30`](https://github.com/metalsmith/permalinks/commit/ec20c3061ab2c192c930bf0e1316bf6286417035)
 
diff --git a/package-lock.json b/package-lock.json
index b4fa99e..7ad439a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@metalsmith/permalinks",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@metalsmith/permalinks",
-      "version": "2.4.1",
+      "version": "2.5.0",
       "license": "MIT",
       "dependencies": {
         "moment": "^2.29.1",
diff --git a/package.json b/package.json
index 4c3da0b..9125c1c 100644
--- a/package.json
+++ b/package.json
@@ -19,7 +19,7 @@
     "type": "git",
     "url": "https://github.com/metalsmith/permalinks.git"
   },
-  "version": "2.4.1",
+  "version": "2.5.0",
   "license": "MIT",
   "source": "src/index.js",
   "main": "lib/index.cjs",