Contact Center · UCCX

Finesse Desktop Layout Builder

Pick the role (agent or supervisor), select which gadgets to show, and get the Finesse layout XML ready to paste into the admin GUI — with sensible defaults for tab order, queue statistics, and wrap-up.

By Faz Karim · 30 yrs Cisco UCLast updated 2026-04-20
What this tool does

Finesse layout XML without the copy-paste hell

Finesse desktop layout is XML. Every line matters — a missing tab or malformed gadget URL breaks the agent desktop for everyone. This tool emits correct, validated XML for agent and supervisor layouts using the gadget list you select, plus an optional 3rd-party CRM gadget URL.

Design your layout

Inputs

Your Finesse layout

Pick gadgets, click Generate Layout XML.

How to read your result

Finesse XML hierarchy

1

finesseLayout

Root element — version must match your Finesse.

2

layout / role

Separate layout per role (agent vs supervisor).

3

tab / tabLabel

Each tab = one browser tab in agent desktop.

4

gadgets

Ordered inside each tab. First gadget is leftmost.

Deep dive

The gadget URL cache trap

When you modify a Finesse gadget URL, Finesse caches the old version for up to 10 minutes per client. If you swap a CRM gadget and one agent sees the old layout, restart their browser or clear cache. Best practice: always append a version query param (?v=20260420) to gadget URLs and bump it on every change — that forces cache invalidation without waiting.

Standard gadgets live at https://<uccx>:8445/desktop/gadgets/. Third-party gadgets must be CORS-enabled and served over HTTPS with a trusted cert. Self-signed certs break Finesse gadget loading in modern browsers — either get a real cert or add to the trust store on every agent PC.

Don't over-stack gadgets in one tab. Three gadgets per tab is the usable maximum; beyond that, agents scroll and miss alerts. Use multiple tabs — Finesse supports up to 10 tabs per role.

FK
Faz Karim30 years Cisco Network · UC · Data Center · LinkedIn
FAQ

Common questions

Where do I paste this XML?

https://<uccx>:8445/cfadmin/ → Desktop Layout → paste the XML → Save.

How do I roll back?

Finesse keeps one prior version. Restore Defaults button reverts to the Cisco default layout.

Can I assign different layouts to different agent teams?

Yes — Finesse supports per-team layouts in the Team Resources section. Otherwise this is the global layout.

My custom gadget loads blank — why?

Usually HTTPS cert trust or CORS. Check browser console for Mixed content blocked or CORS error.

Worked examples

Three Finesse layouts

Small helpdesk — 3 gadgets

Call Control, CSQ Stats, Wrap-up. Single tab.

Minimal config. Fastest load time.
Default Finesse covers this out of the box.

Sales with CRM

Call Control + Wrap-up on tab 1, CRM iframe on tab 2.

CRM gadget URL: https://crm.acme.com/finesse-gadget.xml?v=1
Screen-pop via CTI server REST hook from UCCX script.

Supervisor full

All agent gadgets + Live Monitor + Barge-in + Recording Review.

4 tabs: Agent View, Team, Queue, Recording.
Live Monitor needs Premium UCCX licensing.
Sources verified against current Cisco guidance

Citations

Related tools

You might also need

Finesse layout keeps breaking?

Our UC Modernization Sprint includes Finesse config + CRM gadget integration + per-team layout setup.

$25K–$75Kturnkey
Book a 30-min call →Or email info@famoustec.com