diff --git a/docs/docs/reference/config-migration.md b/docs/docs/reference/config-migration.md
new file mode 100644
index 000000000..9fd590fa7
--- /dev/null
+++ b/docs/docs/reference/config-migration.md
@@ -0,0 +1,37 @@
+# Configuration Migrations
+
+This document describes breaking changes in the configuration file format between Constellation releases.
+
+## Migrating from CLI versions < 2.3
+
+- The `image` field for each cloud service provider has been replaced with a global `image` field. Use the following mapping to migrate your configuration:
+    <details>
+    <summary>Show all</summary>
+
+    | CSP   | old image                                                                                                                                                                             | new image |
+    | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
+    | AWS   | `ami-06b8cbf4837a0a57c`                                                                                                                                                               | `v2.2.2`  |
+    | AWS   | `ami-02e96dc04a9e438cd`                                                                                                                                                               | `v2.2.2`  |
+    | AWS   | `ami-028ead928a9034b2f`                                                                                                                                                               | `v2.2.2`  |
+    | AWS   | `ami-032ac10dd8d8266e3`                                                                                                                                                               | `v2.2.1`  |
+    | AWS   | `ami-032e0d57cc4395088`                                                                                                                                                               | `v2.2.1`  |
+    | AWS   | `ami-053c3e49e19b96bdd`                                                                                                                                                               | `v2.2.1`  |
+    | AWS   | `ami-0e27ebcefc38f648b`                                                                                                                                                               | `v2.2.0`  |
+    | AWS   | `ami-098cd37f66523b7c3`                                                                                                                                                               | `v2.2.0`  |
+    | AWS   | `ami-04a87d302e2509aad`                                                                                                                                                               | `v2.2.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation/images/constellation/versions/2.2.2`     | `v2.2.2`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation_CVM/images/constellation/versions/2.2.2` | `v2.2.2`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation/images/constellation/versions/2.2.1`     | `v2.2.1`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation_CVM/images/constellation/versions/2.2.1` | `v2.2.1`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation/images/constellation/versions/2.2.0`     | `v2.2.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation_CVM/images/constellation/versions/2.2.0` | `v2.2.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation/images/constellation/versions/2.1.0`     | `v2.1.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation_CVM/images/constellation/versions/2.1.0` | `v2.1.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation/images/constellation/versions/2.0.0`     | `v2.0.0`  |
+    | Azure | `/subscriptions/0d202bbb-4fa7-4af8-8125-58c269a05435/resourceGroups/constellation-images/providers/Microsoft.Compute/galleries/Constellation_CVM/images/constellation/versions/2.0.0` | `v2.0.0`  |
+    | GCP   | `projects/constellation-images/global/images/constellation-v2-2-2`                                                                                                                    | `v2.2.2`  |
+    | GCP   | `projects/constellation-images/global/images/constellation-v2-2-1`                                                                                                                    | `v2.2.1`  |
+    | GCP   | `projects/constellation-images/global/images/constellation-v2-2-0`                                                                                                                    | `v2.2.0`  |
+    | GCP   | `projects/constellation-images/global/images/constellation-v2-1-0`                                                                                                                    | `v2.1.0`  |
+    | GCP   | `projects/constellation-images/global/images/constellation-v2-0-0`                                                                                                                    | `v2.0.0`  |
+    </details>
diff --git a/docs/docs/workflows/upgrade.md b/docs/docs/workflows/upgrade.md
index d788e9bb7..5c1bd6f06 100644
--- a/docs/docs/workflows/upgrade.md
+++ b/docs/docs/workflows/upgrade.md
@@ -1,7 +1,16 @@
 # Upgrade your cluster
 
 Constellation provides an easy way to upgrade to the next release.
-This involves choosing a new VM image to use for all nodes in the cluster and updating the cluster's expected measurements.
+This involves updating the CLI, choosing a new VM image to use for all nodes in the cluster and updating the cluster's expected measurements.
+
+## Update the CLI
+
+New features and bug fixes are added to the CLI with every release. To use them, you need to update the CLI to the latest version by following the instructions in the [installation guide](../getting-started/install.md).
+
+## Migrate the configuration
+
+The Constellation configuration file is located in the file `constellation-conf.yaml` in the current working directory.
+Refer to the [migration reference](../reference/config-migration.md) to check if fields in your configuration file need to be updated.
 
 ## Plan the upgrade
 
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 16be5d97d..9edc5af26 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -241,6 +241,11 @@ const sidebars = {
           label: 'CLI',
           id: 'reference/cli',
         },
+        {
+          type: 'doc',
+          label: 'Configuration Migrations',
+          id: 'reference/config-migration',
+        },
       ],
     },
   ],