diff --git a/codefresh/README.md b/codefresh/README.md
index ec4d301e0..cfd9a951e 100644
--- a/codefresh/README.md
+++ b/codefresh/README.md
@@ -834,6 +834,12 @@ Ref:
 - [Create an Index in Atlas DB](https://www.mongodb.com/docs/atlas/atlas-ui/indexes/#create-an-index)
 - [Create an Index with mongosh](https://www.mongodb.com/docs/manual/reference/method/db.collection.createIndex/)
 
+##### ⚠️ Upgrading when the indexes are maintained manually
+
+If you maintain indexes manually and you upgrade your On-Prem installation you must create all indexes which were introduced from your current version up to the version you upgrade to manually.
+
+You can follow [Upgrading section](#upgrading) to see what changes were made for indexes in every specific release.
+
 ### High Availability
 
 The chart installs the non-HA version of Codefresh by default. If you want to run Codefresh in HA mode, use the example values below.
@@ -1742,7 +1748,7 @@ nomios:
     ...
 ```
 
-### To 2.0.12
+### To 2-0-12
 
 #### ⚠️ Legacy ChartMuseum subchart deprecation
 
@@ -2028,6 +2034,12 @@ cfapi:
 
 [Auto-index creation in MongoDB](#auto-index-creation-in-mongodb)
 
+#### ⚠️New indexes in MongoDB
+
+If you maintain indexes manually (i.e. [Auto-index creation](#auto-index-creation-in-mongodb) is off) you must create the following index **before** the upgrade:
+
+- [Database: `read-models`, collection: `images-binaries`, index: `accountId_1_imageName_1`](https://github.com/codefresh-io/codefresh-onprem-helm/tree/release-2.8/indexes/read-models/images-binaries.json#L75-L94)
+
 ### To 2-7-0
 
 ### [What's new in 2.7.x](https://codefresh.io/docs/docs/whats-new/on-prem-release-notes/#on-premises-version-27)
@@ -2037,6 +2049,15 @@ cfapi:
 - Added option to provide global `tolerations`/`nodeSelector`/`affinity` for all Codefresh subcharts
 > **Note!** These global settings will not be applied to Bitnami subcharts (e.g. `mongodb`, `redis`, `rabbitmq`, `postgres`. etc)
 
+#### ⚠️New indexes in MongoDB
+
+If you maintain indexes manually (i.e. [Auto-index creation](#auto-index-creation-in-mongodb) is off) you must create the following indexes **before or right after** the upgrade:
+
+> ⚠ **Note!** In case if you create indexes **before** the upgrade, please, create `codefresh.feature-store-versioned` collection manually in advance.
+
+- [Database: `codefresh`, collection: `feature-store-versioned`, index: `createdAt_1`](https://github.com/codefresh-io/codefresh-onprem-helm/tree/release-2.8/indexes/codefresh/feature-store-versioned.json#L2-L9)
+- [Database: `codefresh`, collection: `feature-store-versioned`, index: `LDRedisStoreVersion_1__id_-1`](https://github.com/codefresh-io/codefresh-onprem-helm/tree/release-2.8/indexes/codefresh/feature-store-versioned.json#L10-L17)
+
 ```yaml
 global:
   tolerations: