Create custom desktop layout

Publisher

Cisco Webex Help Center

URL

https://help.webex.com/en-us/article/ng08gqeb/Create-a-custom-Desktop-layout

Published

2026-03-12

Updated

unknown

Accessed

2026-09-30

HTTP status

200

License

Cisco proprietary; no-redistribution; short excerpts and locators only

Source notes citing this source

• When advancedHeader is enabled the old header is not displayed, and advancedHeader controls visibility and order of built-in header components plus custom widgets. in context
• The appTitle property sets the horizontal header title (default Webex Contact Center) and the logo property takes a hosted image URL, or no-logo to remove the logo. in context
• The area object of each persona holds the customisable layout sections, including panel, navigation, persistent, headless, header and advancedHeader. in context
• All properties in the desktop layout JSON are case sensitive. in context
• For teams that use a custom desktop layout, administrators must periodically refresh the layout definition to pick up new Desktop features. in context
• dragDropEnabled lets agents drag, drop and resize widgets on custom pages and defaults to false. in context
• The Global Layout is a system-generated desktop layout that is assigned by default when a team is created. in context
• The Global Layout cannot be deleted. in context
• Header widgets share a horizontal header that is only 64 pixels high. in context
• headerActions is an array (values webex, outdial, notification) that sets the order of header icons, and an empty array removes all of them. in context
• Widgets in the headless section are hidden from the Desktop and run background logic. in context
• The stock agentx-wc-iframe widget embeds a web page in an iFrame on the Desktop, configured with a src URL and optional style. in context
• If more than one navigation page sets isDefaultLandingPage to true, the first such page becomes the landing page after sign-in. in context
• A navigation item's nav object takes a label (used for tooltip and screen readers), an icon from the Momentum Design library or a custom URL, and iconType momentumDesign or other. in context
• A navigation page's navigateTo value must not be images, fonts, css, build_info, help, app, i18n, icons, images-mfe-wc or sounds. in context
• notificationTimer defaults to 8 seconds with a valid range of 1 to 10, and maximumNotificationCount defaults to 3 with a valid range of 1 to 10. in context
• A navigation page object holds an id, a widgets map and a grid layout of areas with row and column size arrays. in context
• The panel section defines the Auxiliary Information pane as md-tabs, whose predefined tabs are Contact History, IVR Transcript, Customer Experience Journey and Screen Pop, and custom tabs can be added, reordered or removed. in context
• Persistent widgets display on all Desktop pages and appear as a tab in the Auxiliary Information pane only while there is an active contact. in context
• If a new layout is assigned while an agent is signed in, the agent must reload the page to see it. in context
• Downloading the Default Desktop Layout.json file and uploading it again makes it a modified layout even if neither the content nor the filename changed. in context
• Including the ROOT layout as a sublayout of ROOT causes a call stack exceeded error and an infinite loop. in context
• Cisco advises not changing the script URL for an existing component; if you must, agents need to clear the browser cache and reload the Desktop. in context
• A widget can receive real-time Desktop data by setting a property or attribute to a $STORE value such as $STORE.agent.agentName, as an alternative to JavaScript SDK subscribers. in context
• When a supervisor signs in to the Desktop, the layout of the supervisor's primary team is applied. in context
• The layout JSON has separate sections for three personas: agent, supervisor, and supervisorAgent (a supervisor who also handles interactions). in context
• When Cisco adds a new feature to the Desktop Layout, an unmodified layout is updated automatically with the new feature. in context
• The Webex App icon only appears on the Desktop header when desktopChatApp.webexConfigured is true; it defaults to false. in context
• A widget entry names its custom element in comp (without angle brackets) and may give a script URL from which the Desktop loads the component remotely. in context
• A widget entry passes data through attributes and properties objects, and an optional wrapper object adds a toolbar with a title and a maximize icon. in context

Cite this source record

APA

WarmTransfer. (2026, March 12). Create custom desktop layout. WarmTransfer. https://warmtransfer.net/knowledge/sources/cisco-help-ng08gqeb-custom-desktop-layout-b

BibTeX

@misc{warmtransfer-cisco-help-ng08gqeb-custom-desktop-layout-b,
  title  = {Create custom desktop layout},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/sources/cisco-help-ng08gqeb-custom-desktop-layout-b},
  note   = {Cisco Webex Help Center, accessed 2026-09-30}
}