diff --git a/.changeset/brave-dodos-relate.md b/.changeset/brave-dodos-relate.md
index 27dd245d67..bdac06d092 100644
--- a/.changeset/brave-dodos-relate.md
+++ b/.changeset/brave-dodos-relate.md
@@ -2,7 +2,7 @@
 "@latticexyz/world": major
 ---
 
-World config has been rebuilt with strong types. The shape of the config has also changed slightly for clarity.
+World config has been rebuilt with strong types. The shape of the config has also changed slightly for clarity, the biggest change of which is merging of `keySchema` and `valueSchema` into a single `schema` with a separate `key` for the table's primary key.
 
 To migrate, first update the imported config method:
 
diff --git a/.changeset/calm-snails-report.md b/.changeset/calm-snails-report.md
index 73de8ba14b..ccf17fc0b2 100644
--- a/.changeset/calm-snails-report.md
+++ b/.changeset/calm-snails-report.md
@@ -2,7 +2,7 @@
 "@latticexyz/store": major
 ---
 
-Store config has been rebuilt with strong types. The shape of the config has also changed slightly for clarity.
+Store config has been rebuilt with strong types. The shape of the config has also changed slightly for clarity, the biggest change of which is merging of `keySchema` and `valueSchema` into a single `schema` with a separate `key` for the table's primary key.
 
 _Note that the Store config is a subset of the World config and if you have a MUD project, you likely want to follow the World changelog for config migration steps._