diff --git a/docs/reference/announcements/870.md b/docs/reference/announcements/870.md
index d25302a640..cf4c795311 100644
--- a/docs/reference/announcements/870.md
+++ b/docs/reference/announcements/870.md
@@ -4,6 +4,8 @@ title: "8.7 Announcements"
 description: "Important changes and updates for the Camunda 8.7 release including deprecation & removal notices."
 ---
 
+import DeployDiagramImg from '../img/deploy-diagram-modal.png';
+
 Important changes and updates for the Camunda 8.7 release are summarized below.
 
 | Scheduled release date | Scheduled end of maintenance | Release notes                                        | Blog                                                                                            |
@@ -90,6 +92,18 @@ Camunda 8.7 introduces a streamlined architecture, consolidating core components
 
 You can download the alpha release of the unified package from the Camunda GitHub repository, either as an executable Java application (Camunda Orchestration Core) or a Docker image.
 
+:::caution breaking change: Deploy diagram modal
+
+The Web Modeler **Deploy diagram** modal has changed, and clusters must now be proactively configured to be able to deploy from Web Modeler.
+
+<img src={DeployDiagramImg} alt="New 8.7 deploy diagram modal" width="600px" style={{border: '0', paddingTop: '0', marginTop: '0'}} />
+
+- In 8.6, you could still configure cluster details on the **Deploy diagram** modal when deploying.
+- In 8.7, you can no longer configure cluster details on the **Deploy diagram** modal. You must [configure the cluster](/docs/self-managed/modeler/web-modeler/configuration/configuration.md#clusters) to be able to deploy from this modal.
+- Note that you must also be assigned the `Zeebe` [Identity role](/docs/self-managed/identity/user-guide/roles/add-assign-role.md) to be able to deploy.
+
+:::
+
 ### Helm charts
 
 If you are using the recommended Camunda 8 deployment option (Helm charts), the upgrade path from version 8.6 to 8.7 will be straightforward by chaninging the values file to the new syntax. Updated Helm charts will be provided to support the upgrade to the new streamlined architecture.
diff --git a/docs/reference/img/deploy-diagram-modal.png b/docs/reference/img/deploy-diagram-modal.png
new file mode 100644
index 0000000000..ec1c32d412
Binary files /dev/null and b/docs/reference/img/deploy-diagram-modal.png differ