diff --git a/docs/enterprise/updating-embedded.mdx b/docs/enterprise/updating-embedded.mdx
index ffb846e6b0..52a3972d28 100644
--- a/docs/enterprise/updating-embedded.mdx
+++ b/docs/enterprise/updating-embedded.mdx
@@ -16,6 +16,14 @@ Embedded cluster is in beta. If you are instead looking for information about Re
+The following diagram demonstrates how updates are performed with Embedded Cluster in online (internet-connected) environments:
+
+
+
+[View a larger version of this image](/images/embedded-cluster-update.png)
+
+As shown in the diagram above, users check for available updates from the KOTS Admin Console. When deploying the new version, both the application and the cluster infrastructure are updated as needed.
+
## Update in Online Clusters
diff --git a/docs/partials/embedded-cluster/_definition.mdx b/docs/partials/embedded-cluster/_definition.mdx
index 8473a4befa..884b34edff 100644
--- a/docs/partials/embedded-cluster/_definition.mdx
+++ b/docs/partials/embedded-cluster/_definition.mdx
@@ -1,3 +1,3 @@
Replicated Embedded Cluster allows you to distribute a Kubernetes cluster and your application together as a single appliance, making it easy for enterprise users to install, update, and manage the application and the cluster in tandem. Embedded Cluster is based on the open source Kubernetes distribution k0s. For more information, see the [k0s documentation](https://docs.k0sproject.io/stable/).
-For software vendors, Embedded Cluster provides a simplified config for defining characteristics of the cluster that will be created in the customer environment. Additionally, each version of Embedded Cluster includes a specific version of Replicated KOTS, ensuring compatibility between KOTS and the cluster. For enterprise users, cluster updates are done automatically at the same time as application updates, allowing users to more easily keep the cluster up-to-date without needing to use kubectl.
\ No newline at end of file
+For software vendors, Embedded Cluster provides a Config for defining characteristics of the cluster that will be created in the customer environment. Additionally, each version of Embedded Cluster includes a specific version of Replicated KOTS, ensuring compatibility between KOTS and the cluster. For enterprise users, cluster updates are done automatically at the same time as application updates, allowing users to more easily keep the cluster up-to-date without needing to use kubectl.
\ No newline at end of file
diff --git a/docs/vendor/embedded-overview.mdx b/docs/vendor/embedded-overview.mdx
index b66cc7f138..1e3bbf7b22 100644
--- a/docs/vendor/embedded-overview.mdx
+++ b/docs/vendor/embedded-overview.mdx
@@ -16,6 +16,16 @@ Embedded cluster is in beta. If you are instead looking for information about cr
+The following diagram demonstrates how Kubernetes and an application are installed into a customer environment using Embedded Cluster:
+
+
+
+[View a larger version of this image](/images/embedded-cluster-install.png)
+
+As shown in the diagram above, the Embedded Cluster Config is included in the application release in the Replicated Vendor Portal and is used to generate the Embedded Cluster installation assets. Users can download these installation assets from the Replicated app service (`replicated.app`) on the command line, then run the Embedded Cluster installation command to install Kubernetes and the KOTS Admin Console. Finally, users access the Admin Console to optionally add nodes to the cluster and to configure and install the application.
+
+### Comparison to kURL
+
### Requirements
diff --git a/static/images/embedded-cluster-install.png b/static/images/embedded-cluster-install.png
new file mode 100644
index 0000000000..f9f031a976
Binary files /dev/null and b/static/images/embedded-cluster-install.png differ
diff --git a/static/images/embedded-cluster-update.png b/static/images/embedded-cluster-update.png
new file mode 100644
index 0000000000..f21be47b46
Binary files /dev/null and b/static/images/embedded-cluster-update.png differ