diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8b436aefdc57580dcc36d2bf74f55b46144a7bfa..440c38eeb108077446168afbaa68c384a60069a0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,21 @@
 
+<a name="v3.1.0"></a>
+## [v3.1.0] - 2023-01-06
+### Add Features
+- new websocket datasource
+
+### Bug Fixes
+- return error in test
+- missing callbacks
+
+### Changes
+- tests
+- administration changes
+- doc
+- remove unused import
+- doc + tidy
+
+
 <a name="v3.0.0"></a>
 ## [v3.0.0] - 2023-01-04
 ### Changes
@@ -113,6 +130,7 @@
 <a name="1.8.0"></a>
 ## 1.8.0 - 2021-08-15
 
+[v3.1.0]: https://gitlab.schukai.com/oss/libraries/javascript/monster/compare/v3.0.0...v3.1.0
 [v3.0.0]: https://gitlab.schukai.com/oss/libraries/javascript/monster/compare/v2.2.1...v3.0.0
 [v2.2.1]: https://gitlab.schukai.com/oss/libraries/javascript/monster/compare/v2.2.0...v2.2.1
 [v2.2.0]: https://gitlab.schukai.com/oss/libraries/javascript/monster/compare/v2.1.1...v2.2.0