diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
index b1c589b1a..78f6cbc7e 100644
--- a/docs/.vuepress/config.js
+++ b/docs/.vuepress/config.js
@@ -45,7 +45,7 @@ function docsSidebar(title) {
 		{
 			title,
 			collapsable: false,
-			children: ["", "identity-providers", "signed-headers", "certificates", "examples"]
+			children: ["", "identity-providers", "signed-headers", "certificates", "examples", "upgrading"]
 		}
 	];
 }
diff --git a/docs/docs/upgrading.md b/docs/docs/upgrading.md
new file mode 100644
index 000000000..45c5bd04a
--- /dev/null
+++ b/docs/docs/upgrading.md
@@ -0,0 +1,18 @@
+---
+title: Upgrading
+description: >-
+  This page contains the list of deprecations and important or breaking changes
+  for Pomerium. Please read it carefully.
+---
+
+# Overview
+
+## Since 0.0.4
+
+This page contains the list of deprecations and important or breaking changes for pomerium `v0.0.4` compared to `v0.0.5`. Please read it carefully.
+
+### X
+
+### Y
+
+### Z