diff --git a/docs/upgrade_oracle.md b/docs/kava-8/upgrade_oracle.md
similarity index 100%
rename from docs/upgrade_oracle.md
rename to docs/kava-8/upgrade_oracle.md
diff --git a/docs/upgrade_validator.md b/docs/kava-8/upgrade_validator.md
similarity index 100%
rename from docs/upgrade_validator.md
rename to docs/kava-8/upgrade_validator.md
diff --git a/docs/upgrade_wallet.md b/docs/kava-8/upgrade_wallet.md
similarity index 100%
rename from docs/upgrade_wallet.md
rename to docs/kava-8/upgrade_wallet.md
diff --git a/docs/readme.md b/docs/readme.md
index 82e4df19..8127037f 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -38,9 +38,9 @@ f0c90f0cbf96d230a83cd2309b8fd032e52d7fb933881541472df1bf2703a939  -
 
 For additional information about upgrades:
 
-- Upgrading a [Validator](https://github.com/Kava-Labs/kava/blob/master/docs/upgrade_validator.md)
-- Upgrading a [Wallet](https://github.com/Kava-Labs/kava/blob/master/docs/upgrade_wallet.md)
-- Upgrading an [Oracle](https://github.com/Kava-Labs/kava/blob/master/docs/upgrade_oracle.md)
+- Upgrading a [Validator](https://github.com/Kava-Labs/kava/blob/master/docs/kava-8/upgrade_validator.md)
+- Upgrading a [Wallet](https://github.com/Kava-Labs/kava/blob/master/docs//kava-8/upgrade_wallet.md)
+- Upgrading an [Oracle](https://github.com/Kava-Labs/kava/blob/master/docs//kava-8/upgrade_oracle.md)
 
 ### Validator Guide