AWS Security ChangesHomeSearch

AWS AmazonECR: Document delete-replication option for ECR registry replication rules

Service: AmazonECR · 2026-11-17 · Documentation low

File: AmazonECR/latest/userguide/registry-settings-configure.md

Summary

Adds instructions for the optional Delete replication setting in the console (new step 10, renumbering Review and submit to step 11) and the JSON `deleteReplication` parameter for cross-Region/cross-account replication rules, plus a note that deletions are not replicated by default. Also normalizes an 'Important' heading level.

Security assessment

This documents a new data-lifecycle replication feature (replicating image/tag deletions to destination registries). It is a feature/configuration change rather than a fix for a specific vulnerability, credential, authorization, or encryption issue, so it is not security_issue_related. Default-off behavior is noted, which is a mild safe-default statement, but there is no security-specific guidance or hardening content.

Evidence

  10. (Optional) For **Delete replication** , choose whether to replicate image deletions and image tag removals to the destinations for this rule. By default, Amazon ECR doesn't replicate deletions. For more information, see [Replicating image deletions in Amazon ECR](./replication-delete.html).

Diff

diff --git a/AmazonECR/latest/userguide/registry-settings-configure.md b/AmazonECR/latest/userguide/registry-settings-configure.md
index 52af1d1..73e0642 100644
--- a//AmazonECR/latest/userguide/registry-settings-configure.md
+++ b//AmazonECR/latest/userguide/registry-settings-configure.md
@@ -29 +29 @@ For examples of how replication is commonly used, see [Private image replication
-###### Important
+Important
@@ -35 +35 @@ For cross-account replication to occur, the destination account must configure a
-  10. On the **Review and submit** page, review the replication rule configuration and then choose **Submit rule**.
+  10. (Optional) For **Delete replication** , choose whether to replicate image deletions and image tag removals to the destinations for this rule. By default, Amazon ECR doesn't replicate deletions. For more information, see [Replicating image deletions in Amazon ECR](./replication-delete.html).
@@ -36,0 +37 @@ For cross-account replication to occur, the destination account must configure a
+  11. On the **Review and submit** page, review the replication rule configuration and then choose **Submit rule**.
@@ -40 +41,2 @@ For cross-account replication to occur, the destination account must configure a
-  1. Create a JSON file containing the replication rules to define for your registry. A replication configuration may contain up to 10 rules, with up to 25 unique destinations across all rules and 100 filters per each rule. To configure cross-Region replication within your own account, you specify your own account ID. For more examples, see [Private image replication examples for Amazon ECR](./registry-settings-examples.html).
+
+  1. Create a JSON file containing the replication rules to define for your registry. A replication configuration may contain up to 10 rules, with up to 25 unique destinations across all rules and 100 filters per each rule. To configure cross-Region replication within your own account, you specify your own account ID. To enable replication of deletes for the rule, include the `deleteReplication` parameter with `enabled` set to `true`. For more examples, see [Private image replication examples for Amazon ECR](./registry-settings-examples.html).
@@ -51 +53,4 @@ For cross-account replication to occur, the destination account must configure a
-    		}]
+    		}],
+    		"deleteReplication": {
+    			"enabled": true
+    		}