diff --git a/CHANGELOG.md b/CHANGELOG.md
index 68b6859a3..103925622 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,7 +12,16 @@ way to update this template, but currently, we follow a pattern:
 
 ---
 
-## Upcoming version 2023-XX-XX
+## Upcoming version 2024-XX-XX
+
+## [v4.0.0] 2024-02-07
+
+Breaking change: if you have customized your transaction process, you need to update the email templates. The new customer commission (#293) adds changes to emails that contain a receipt aka order breakdown information. In addition, also PR 310 touches the email templates.
+
+This also prepares the codebase for future configuration possibilities:
+- Postponing the requirement for a provider to give payout details (but it is still needed)
+- Makes certain listing features optional (location, delivery method)
+- Adds infinity stock (It is just emulated through a big number 10^15)
 
 - [add] Update de.json asset. [#313](https://github.com/sharetribe/web-template/pull/313)
 - [add] Update fr.json asset. [#311](https://github.com/sharetribe/web-template/pull/311)
@@ -63,6 +72,8 @@ way to update this template, but currently, we follow a pattern:
 - [fix] Add missing imports to an email template file
   [#279](https://github.com/sharetribe/web-template/pull/279)
 
+  [v4.0.0]: https://github.com/sharetribe/web-template/compare/v3.5.0...v4.0.0
+
 ## [v3.5.0] 2023-12-12
 
 - [fix] OrderPanel: showed price for inquiry on mobile layout even if price was marked hidden
diff --git a/package.json b/package.json
index d9c851288..133b6d7c7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "app",
-  "version": "3.5.0",
+  "version": "4.0.0",
   "private": true,
   "license": "Apache-2.0",
   "dependencies": {