diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1092ea48..05de2f6d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,19 @@
+# [3.0.0](https://github.com/jagregory/cognito-local/compare/v2.3.2...v3.0.0) (2021-07-28)
+
+
+### Bug Fixes
+
+* conflation of a user's Sub and their Username ([ece63b6](https://github.com/jagregory/cognito-local/commit/ece63b6f037e25f3fae67003df59bc652d2ada79))
+
+
+### BREAKING CHANGES
+
+* potential -- the autogenerated Sub and user-supplied
+Username were treated interchangeably before, but now are independent.
+Previously lookups by the Sub attribute were possible, but it now
+doesn't appear necessary so has been removed. Databases should be
+unaffected.
+
 ## [2.3.2](https://github.com/jagregory/cognito-local/compare/v2.3.1...v2.3.2) (2021-07-27)