AWS Security ChangesHomeSearch

AWS wellarchitected: Rewrite WA Agent recommendation sharing steps (drop access-level scope)

Service: wellarchitected · 2026-10-23 · Documentation low

File: wellarchitected/latest/userguide/agent-share-rec.md

Summary

Restructured the 'Share recommendations' instructions: the previous account-based flow (share with All affected accounts or Custom accounts, choose Read only or Read/write access level, and view/manage shared accounts) is replaced with a simplified email-based share dialog opened from the dashboard or the recommendation detail page.

Security assessment

This is a UX documentation rewrite. The only security-adjacent element is the removal of the documented 'Read only' vs 'Read/write' access-level choice and the account-list sharing model, which previously gave readers permission-scoping guidance; the replacement text says nothing about granted privilege scope. No vulnerability, CVE, or control change is referenced, so this is treated as low.

Evidence

-  6. Choose an access level: **Read only** or **Read/write**.

Diff

diff --git a/wellarchitected/latest/userguide/agent-share-rec.md b/wellarchitected/latest/userguide/agent-share-rec.md
index d9cb6c2..475fa2d 100644
--- a//wellarchitected/latest/userguide/agent-share-rec.md
+++ b//wellarchitected/latest/userguide/agent-share-rec.md
@@ -13,9 +13 @@ Share specific recommendations with other AWS accounts or team members to collab
-You can share recommendations in two ways:
-
-**From the dashboard:**
-
-In **All recommendations** , select the radio button next to a recommendation and choose **Share**. Enter the email addresses of your intended recipients and choose **Share** to send.
-
-**From the recommendation detail page:**
-
-You can also share recommendations from within the detail page that opens when you click a recommendation.
+You can share a recommendation by email from either the AWS WA Agent dashboard or the recommendation detail page. Both entry points open the same share dialog.
@@ -25,7 +17 @@ You can also share recommendations from within the detail page that opens when y
-  1. Click the title of the specific recommendation you want to share. 
-
-  2. Choose **Actions** in the top right corner of the recommendation detail dialog, then **Share Recommendation** to share with other AWS accounts. 
-
-  3. Choose whether to share the recommendation with **All affected accounts** or **Custom accounts**. 
-
-  4. If you selected **All affected accounts** , select the radio buttons next to each account you want to share the recommendation with. 
+  1. Open the share dialog from one of the following locations:
@@ -33 +19 @@ You can also share recommendations from within the detail page that opens when y
-  5. If you selected **Custom accounts** , enter a comma-separated list of AWS account IDs to share with (up to 100 accounts).
+     * **From the dashboard:** Choose the radio button next to the recommendation you want to share, then choose **Share**.
@@ -35 +21 @@ You can also share recommendations from within the detail page that opens when y
-  6. Choose an access level: **Read only** or **Read/write**.
+     * **From the recommendation detail page:** Choose **Actions** in the top right corner, then **Share recommendation**.
@@ -37 +23 @@ You can also share recommendations from within the detail page that opens when y
-  7. Choose **Share recommendation**.
+  2. Enter the email address you want to share the recommendation with.
@@ -38,0 +25 @@ You can also share recommendations from within the detail page that opens when y
+  3. Choose **Share**.
@@ -42 +28,0 @@ You can also share recommendations from within the detail page that opens when y
-To view or manage shared access, choose **Accounts recommendation shared with** on the recommendation detail page. You can view shared accounts in a list or JSON format, and un-share the recommendation with specific accounts.