diff --git a/README.md b/README.md
index e54f5793..48e72a7c 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,29 @@ As with other schema projects, here we separate between the schema source files
 
 There is a set of tools in [`/bin`](./bin/) to facilitate the conversion. ATM, after editing `...yaml` schema files somewhere in the `/src` tree, a (local) run of `bin/yamlerRunner.sh` - which re-generates the `....json` files in the `/json` tree) has to be performed before pushing changes.
 
-### Changes
+### Changelog
+
+## 2.1.0
+
+*Released, July, 19, 2024*
+
+* Relocated TypedQuantity required to proper level of the schema for complexValue
+* Added end and start entities for ageRange and iso8601duration for age
+* Filtering terms scopes changed from string to array of strings
+
+## 2.0.1
+
+*Released July, 16, 2024*
+
+* Replaced ENSGLOSSARY for SO ontology family in documentation examples
+* Moved CURIE to beaconCommonComponents
+* Created filtering terms entity
+* Removed validation directories
+* Several fixes to entity types, typos and other non-breaking changes
+
+## 2.0.0
+
+*Released June, 21, 2022*
 
 * change notes with respect to the repository & documentation are now in [docs.genomebeacons.org](https://docs.genomebeacons.org/changes-todo/)
 * NOTE: on 2022-06-20 the previous development repositories have been archived: