From 779abfda0ca8ec214c49632b9b624b1f5965404e Mon Sep 17 00:00:00 2001
From: Sebastian <sebastian@squidex.io>
Date: Thu, 8 Oct 2020 17:40:13 +0200
Subject: [PATCH] Changelog for 5.0.0

---
 CHANGELOG.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a417eff84b..9070e444cc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,33 @@
 # Changelog
 
+## 5.0.0 - 2020-10-08
+
+This feature adds custom IDs to the system. So far every ID like a content ID is globally unique. This means that you cannot create custom IDs and when a backup is restored you need to assign new ids, because the old IDs might be already in use.
+
+With this version on, every ID is prefixed with the app id, meaning they are only unique within an app. This allows new endpoints for upserting contents and defininig custom ids for assets.
+
+### WARNING: MIGRATION
+
+This version has to migrate a few mongo collections:
+
+* Events
+* States_AssetFolders
+* States_Assets
+* State_Contents_All
+* State_Contents_Published
+
+This process will start automatically and can take a while. To be backwards compatible when you experience a bug, new collections are created. The new collection names are
+
+* Events2
+* States_AssetFolders2
+* States_Assets2
+* States_Contents_All2
+* States_Contents_Published2
+
+(As you can see the collection names have been streamlined.)
+
+If everything works fine for you, you can delete the old collections.
+
 ## 4.7.0 - 2020-09-29
 
 ### Features