diff --git a/CHANGELOG.md b/CHANGELOG.md
index 11023d6b..dca289f7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,8 +5,17 @@ This project adheres to [Semantic Versioning](http://semver.org/) and [Keep a Ch
 
 ## Unreleased
 
+### New
+
+### Changes
+
+### Fixes
+
+## v4.0.0 (2024-06-03)
+
 ### New
 - adding support for S3 to store bundles
+  - see [UPGRADE to 4.0.0](https://seed-farmer.readthedocs.io/en/latest/upgrades.html#upgrading-to-4-0-0)
 - adding seedfarmer version tag to toolchain and deployment roles
 - removing python 3.7 support
 - adding python 3.12 support 
diff --git a/VERSION b/VERSION
index 60b10291..72490fd8 100644
--- a/VERSION
+++ b/VERSION
@@ -1,2 +1,2 @@
-4.0.0.dev0
+4.0.0