diff --git a/packages/twenty-emails/package.json b/packages/twenty-emails/package.json
index 1f20fbe7eb64..e42c2b318a21 100644
--- a/packages/twenty-emails/package.json
+++ b/packages/twenty-emails/package.json
@@ -1,6 +1,6 @@
 {
   "name": "twenty-emails",
-  "version": "0.31.0-canary",
+  "version": "0.31.0",
   "description": "",
   "author": "",
   "private": true,
diff --git a/packages/twenty-front/package.json b/packages/twenty-front/package.json
index 9370f2460b92..90bd99f40175 100644
--- a/packages/twenty-front/package.json
+++ b/packages/twenty-front/package.json
@@ -1,6 +1,6 @@
 {
   "name": "twenty-front",
-  "version": "0.31.0-canary",
+  "version": "0.31.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/packages/twenty-server/package.json b/packages/twenty-server/package.json
index d5c8f91b9c69..1f94d52eff93 100644
--- a/packages/twenty-server/package.json
+++ b/packages/twenty-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "twenty-server",
-  "version": "0.31.0-canary",
+  "version": "0.31.0",
   "description": "",
   "author": "",
   "private": true,
diff --git a/packages/twenty-ui/package.json b/packages/twenty-ui/package.json
index 3e9aadc6ce64..ecf63eb4cbdf 100644
--- a/packages/twenty-ui/package.json
+++ b/packages/twenty-ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "twenty-ui",
-  "version": "0.31.0-canary",
+  "version": "0.31.0",
   "type": "module",
   "main": "./src/index.ts",
   "exports": {
diff --git a/packages/twenty-website/package.json b/packages/twenty-website/package.json
index f3ca9e2137db..9db997579234 100644
--- a/packages/twenty-website/package.json
+++ b/packages/twenty-website/package.json
@@ -1,6 +1,6 @@
 {
   "name": "twenty-website",
-  "version": "0.31.0-canary",
+  "version": "0.31.0",
   "private": true,
   "scripts": {
     "nx": "NX_DEFAULT_PROJECT=twenty-website node ../../node_modules/nx/bin/nx.js",
diff --git a/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx b/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
index 8a71df02a433..c260b6a04178 100644
--- a/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
+++ b/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
@@ -22,6 +22,8 @@ Migrating a CRM is a bit trickier than migrating a traditional software, because
 
 ## v0.21.0 to v0.22.0
 
+Upgrade your Twenty instance to use v0.22.0 image
+
 Run the following commands:
 
 ```
@@ -36,6 +38,8 @@ The `yarn command:prod upgrade-0.22` command will apply specific data transforma
 
 ## v0.22.0 to v0.23.0
 
+Upgrade your Twenty instance to use v0.23.0 image
+
 Run the following commands:
 
 ```
@@ -48,6 +52,8 @@ The `yarn command:prod upgrade-0.23` takes care of the data migration, including
 
 ## v0.23.0 to v0.24.0
 
+Upgrade your Twenty instance to use v0.24.0 image
+
 Run the following commands:
 
 ```
@@ -80,4 +86,17 @@ yarn command:prod upgrade-0.30
 The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
 The `yarn command:prod upgrade-30` takes care of the data migration of all workspaces.
 
+# v0.30.0 to v0.31.0
+
+Upgrade your Twenty instance to use v0.31.0 image
+
+**Schema and data migration**: 
+```
+yarn database:migrate:prod
+yarn command:prod upgrade-0.31
+```
+
+The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
+The `yarn command:prod upgrade-31` takes care of the data migration of all workspaces.
+
 <ArticleEditContent></ArticleEditContent>