Stay organized with collections
Save and categorize content based on your preferences.
With agent desktop, you can create customized desktop layouts for different use
cases for your human agents. These include receiving inbound calls, placing
outbound calls, and handling chat sessions. Your layouts can contain call
adapters, chat adapters, and wide variety of panels for other capabilities such
as live transcripts, knowledge assist, and session data feeds. You can also
configure custom panels to use as widgets
that you can drag into panels.
After you create a desktop layout, you can configure which layouts agents see,
depending on session type and other factors. These factors include team
membership and which queue a session arrives in. For more information, see Set
desktop layouts for agents.
Create a desktop layout
To create a desktop layout for placing an outbound call, receiving an inbound
call, or handling a chat session, follow these steps:
In the CCAI Platform portal, click Settings > Operation
Management. If you don't see the Settings menu, click menuMenu.
Go to the Agent Desktop pane.
For Desktop Layout, click Manage Desktop Layout Lists. The Desktop
Layout Builder page appears.
Click Add desktop layout. The Add desktop layout dialog appears.
In the Desktop Layout Name field, enter a name for your desktop layout.
For Channel, select Call Adapter or Chat Adapter, depending on
the type of session the layout is for.
Optional: For Panel Size Control, clear the Allow Agents To Control
Size of Panels checkbox if you don't want agents to change the panel
sizes.
Click Next. The desktop layout appears.
To customize the number and size the panels, do any of the following:
Click Split panel to split
a panel.
Click closeClose this panel to
close a panel.
Drag lines between panels to resize the panels.
To configure adapter settings, do one or both of the following:
Select the External checkbox if you're using an external call
adapter. The Call Adapter pane no longer displays.
To display a chat adapter with the call adapter, select the Chat
Adapter checkbox .
Drag a widget into a panel. For widgets that require Agent Assist,
be sure to set up Agent Assist.
Continue dragging widgets into panels until every panel has a widget. Drag
the Session Data Feed widget into a panel if you want to capture data
about sessions for later analysis. For more information, see Session data
feed.
Click Save. Your new layout appears in the Desktop Layout list.
Edit a desktop layout
To edit a desktop layout, follow these steps:
In the CCAI Platform portal, click Settings > Operation
Management. If you don't see the Settings menu, click menuMenu.
Go to the Agent Desktop pane.
For Desktop Layout, click Manage Desktop Layout Lists. The Desktop
Layout Builder page appears.
For the desktop layout that you want to edit, click more_horizMore, and then click Edit
Layout. The Desktop Layout Builder page appears.
Make changes to the layout, and then click Save.
Duplicate a desktop layout
To duplicate a desktop layout, follow these steps:
In the CCAI Platform portal, click Settings > Operation
Management. If you don't see the Settings menu, click menuMenu.
Go to the Agent Desktop pane.
For Desktop Layout, click Manage Desktop Layout Lists. The Desktop
Layout Builder page appears.
For the desktop layout that you want to duplicate, click more_horizMore, and then click
Duplicate. A duplicate desktop layout appears.
Rename a desktop layout
To rename a desktop layout, follow these steps:
In the CCAI Platform portal, click Settings > Operation
Management. If you don't see the Settings menu, click menuMenu.
Go to the Agent Desktop pane.
For Desktop Layout, click Manage Desktop Layout Lists. The Desktop
Layout Builder page appears.
For the desktop layout that you want to rename, click more_horizMore, and then click Edit
Layout Setting. The Edit desktop layout dialog appears.
In the Desktop layout name field, enter a new name.
Optional: To change whether agents can control the size of panels, select or
clear the Allow agents to control size of panels checkbox.
Click Save.
Delete a desktop layout
To delete a desktop layout, follow these steps:
In the CCAI Platform portal, click Settings > Operation
Management. If you don't see the Settings menu, click menuMenu.
Go to the Agent Desktop pane.
For Desktop Layout, click Manage Desktop Layout Lists. The Desktop
Layout Builder page appears.
For the desktop layout that you want to delete, click more_horizMore, and then click
Delete. The Delete layout dialog appears.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Create desktop layouts\n\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nWith agent desktop, you can create customized desktop layouts for different use\ncases for your human agents. These include receiving inbound calls, placing\noutbound calls, and handling chat sessions. Your layouts can contain call\nadapters, chat adapters, and wide variety of panels for other capabilities such\nas live transcripts, knowledge assist, and session data feeds. You can also\n[configure custom panels](/contact-center/ccai-platform/docs/agent-desktop-configure-widgets) to use as widgets\nthat you can drag into panels.\n\nAfter you create a desktop layout, you can configure which layouts agents see,\ndepending on session type and other factors. These factors include team\nmembership and which queue a session arrives in. For more information, see [Set\ndesktop layouts for agents](/contact-center/ccai-platform/docs/agent-desktop-set-desktop-layouts).\n\nCreate a desktop layout\n-----------------------\n\nTo create a desktop layout for placing an outbound call, receiving an inbound\ncall, or handling a chat session, follow these steps:\n\n1. In the CCAI Platform portal, click **Settings \\\u003e Operation\n Management** . If you don't see the **Settings** menu, click menu **Menu**.\n\n2. Go to the **Agent Desktop** pane.\n\n3. For **Desktop Layout** , click **Manage Desktop Layout Lists** . The **Desktop\n Layout Builder** page appears.\n\n4. Click **Add desktop layout** . The **Add desktop layout** dialog appears.\n\n5. In the **Desktop Layout Name** field, enter a name for your desktop layout.\n\n6. For **Channel** , select **Call Adapter** or **Chat Adapter**, depending on\n the type of session the layout is for.\n\n7. Optional: For **Panel Size Control** , clear the **Allow Agents To Control\n Size of Panels** checkbox if you don't want agents to change the panel\n sizes.\n\n8. Click **Next**. The desktop layout appears.\n\n9. To customize the number and size the panels, do any of the following:\n\n - Click **Split panel** to split\n a panel.\n\n - Click close **Close this panel** to\n close a panel.\n\n - Drag lines between panels to resize the panels.\n\n10. To configure adapter settings, do one or both of the following:\n\n - Select the **External** checkbox if you're using an external call\n adapter. The **Call Adapter** pane no longer displays.\n\n - To display a chat adapter with the call adapter, select the **Chat\n Adapter** checkbox .\n\n11. Drag a widget into a panel. For widgets that require Agent Assist,\n be sure to [set up Agent Assist](/contact-center/ccai-platform/docs/agent-assist#set-up-agent-assist).\n\n12. Continue dragging widgets into panels until every panel has a widget. Drag\n the **Session Data Feed** widget into a panel if you want to capture data\n about sessions for later analysis. For more information, see [Session data\n feed](/contact-center/ccai-platform/docs/agent-desktop-session-data-feed).\n\n13. Click **Save** . Your new layout appears in the **Desktop Layout** list.\n\nEdit a desktop layout\n---------------------\n\nTo edit a desktop layout, follow these steps:\n\n1. In the CCAI Platform portal, click **Settings \\\u003e Operation\n Management** . If you don't see the **Settings** menu, click menu **Menu**.\n\n2. Go to the **Agent Desktop** pane.\n\n3. For **Desktop Layout** , click **Manage Desktop Layout Lists** . The **Desktop\n Layout Builder** page appears.\n\n4. For the desktop layout that you want to edit, click more_horiz **More** , and then click **Edit\n Layout** . The **Desktop Layout Builder** page appears.\n\n5. Make changes to the layout, and then click **Save**.\n\nDuplicate a desktop layout\n--------------------------\n\nTo duplicate a desktop layout, follow these steps:\n\n1. In the CCAI Platform portal, click **Settings \\\u003e Operation\n Management** . If you don't see the **Settings** menu, click menu **Menu**.\n\n2. Go to the **Agent Desktop** pane.\n\n3. For **Desktop Layout** , click **Manage Desktop Layout Lists** . The **Desktop\n Layout Builder** page appears.\n\n4. For the desktop layout that you want to duplicate, click more_horiz **More** , and then click\n **Duplicate**. A duplicate desktop layout appears.\n\nRename a desktop layout\n-----------------------\n\nTo rename a desktop layout, follow these steps:\n\n1. In the CCAI Platform portal, click **Settings \\\u003e Operation\n Management** . If you don't see the **Settings** menu, click menu **Menu**.\n\n2. Go to the **Agent Desktop** pane.\n\n3. For **Desktop Layout** , click **Manage Desktop Layout Lists** . The **Desktop\n Layout Builder** page appears.\n\n4. For the desktop layout that you want to rename, click more_horiz **More** , and then click **Edit\n Layout Setting** . The **Edit desktop layout** dialog appears.\n\n5. In the **Desktop layout name** field, enter a new name.\n\n6. Optional: To change whether agents can control the size of panels, select or\n clear the **Allow agents to control size of panels** checkbox.\n\n7. Click **Save**.\n\nDelete a desktop layout\n-----------------------\n\nTo delete a desktop layout, follow these steps:\n\n1. In the CCAI Platform portal, click **Settings \\\u003e Operation\n Management** . If you don't see the **Settings** menu, click menu **Menu**.\n\n2. Go to the **Agent Desktop** pane.\n\n3. For **Desktop Layout** , click **Manage Desktop Layout Lists** . The **Desktop\n Layout Builder** page appears.\n\n4. For the desktop layout that you want to delete, click more_horiz **More** , and then click\n **Delete** . The **Delete layout** dialog appears.\n\n5. Click **Delete**."]]