AWS Security ChangesHomeSearch

AWS connect: New page: assign agent workspace layout to agents

Service: connect · 2026-11-06 · Documentation low

File: connect/latest/adminguide/assign-agent-workspace-layout.md · Type: iam

Summary

Adds a new administrator guide page describing how to create a workspace, choose an Agent Workspace layout, and assign it to users or routing profiles, including a note on the security profile permissions required to manage workspaces.

Security assessment

The page is primarily a UI/configuration how-to, but it explicitly documents the IAM-style security profile permissions needed to view, edit, create, delete, assign, and change visibility of workspaces, which is least-privilege guidance for administrators. No vulnerability, CVE, or incident is referenced, so it is security-adjacent documentation rather than a fix.

Evidence

+Your security profile needs permissions to view, edit, create, delete, assign, and edit visibility of workspaces. To add these permissions, go to the **Security profiles** page. For the full list of permissions, see [List of security profile permissions](./security-profile-list.html#users-permissions-list).

Diff

diff --git a/connect/latest/adminguide/assign-agent-workspace-layout.md b/connect/latest/adminguide/assign-agent-workspace-layout.md
index 8b13789..6a982b5 100644
--- a//connect/latest/adminguide/assign-agent-workspace-layout.md
+++ b//connect/latest/adminguide/assign-agent-workspace-layout.md
@@ -0,0 +1 @@
+[View a markdown version of this page](assign-agent-workspace-layout.md)
@@ -1,0 +3,91 @@
+[](/pdfs/connect/latest/adminguide/connect-ag.pdf#assign-agent-workspace-layout "Open PDF")
+
+[Documentation](/index.html)[Amazon Connect Customer](/connect/index.html)[Administrator Guide](what-is-amazon-connect.html)
+
+Create a workspace and set the layoutAssign the workspace to agents
+
+# Assign an agent workspace layout to agents
+
+To assign a layout to agents, create a workspace, select a layout, and assign the workspace to agents. Agents who are not assigned a workspace continue to use the original layout of the agent workspace.
+
+###### Note
+
+Your security profile needs permissions to view, edit, create, delete, assign, and edit visibility of workspaces. To add these permissions, go to the **Security profiles** page. For the full list of permissions, see [List of security profile permissions](./security-profile-list.html#users-permissions-list).
+
+## Create a workspace and set the layout
+
+  1. Open the Connect Customer admin workspace.
+
+  2. Go to **UI Management** > **Workspaces**.
+
+  3. Choose **Add new workspace**.
+
+  4. Enter a name for the workspace. Optionally, enter a description, which only administrators see, and a title, which replaces **Amazon Connect Customer** in the header bar unless you use a custom logo.
+
+  5. Choose **Save**. Amazon Connect Customer creates the workspace and opens its details page.
+
+  6. In the **Pages** section, choose **Add page**.
+
+  7. Choose **Use existing Connect page**.
+
+  8. For **Page** , choose **Agent Workspace**.
+
+  9. For **Page layout** , choose **Agent Workspace - Classic** or **Agent Workspace - Modern**.
+
+  10. For **View version** , choose **LATEST**.
+
+  11. (Optional) In the **Customize apps on Agent Workspace** section, choose a layout for the Customer Profiles app. For more information, see [Show Profile Explorer in the agent workspace](./add-profileexplorer-to-agentworkspace.html).
+
+  12. Choose **Save**.
+
+
+
+
+## Assign the workspace to agents
+
+Agents see the layout after you assign them the workspace.
+
+  1. On the workspace details page, go to the **Assignments** section.
+
+  2. Open the visibility dropdown and choose one of the following:
+
+     * **Visible to all users** shows the workspace to every user in your instance.
+
+     * **Visible to assigned users** shows the workspace only to the users and routing profiles that you assign.
+
+     * **Visible to no users** hides the workspace while you prepare or test it.
+
+  3. If you chose **Visible to assigned users** , choose **Add assignments**.
+
+  4. For **Users** , search for and choose the agents who use this layout.
+
+  5. For **Routing profiles** , search for and choose a routing profile. Assigning a routing profile assigns the workspace to every agent in it, which is the fastest way to reach a team.
+
+  6. Choose **Save**.
+
+
+
+
+To remove a user or routing profile from the workspace, select the assignment and choose **Delete**.
+
+![Warning](https://d1ge0kk1l5kms0.cloudfront.net/images/G/01/webservices/console/warning.png) **Javascript is disabled or is unavailable in your browser.**
+
+To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.
+
+[Document Conventions](/general/latest/gr/docconventions.html)
+
+Choose a layout
+
+Access the Worklist app
+
+Did this page help you? - Yes
+
+Thanks for letting us know we're doing a good job!
+
+If you've got a moment, please tell us what we did right so we can do more of it.
+
+Did this page help you? - No
+
+Thanks for letting us know this page needs work. We're sorry we let you down.
+
+If you've got a moment, please tell us how we can make the documentation better.