Add Teams & Zoom Optimization to Citrix Workspace (If You Skipped It at Install)
A common mix-up: people expect Teams and Zoom to be tick-boxes during the Citrix Workspace app (CWA) install, then worry they “missed” them. They’re not — CWA optimizes each app differently. Here’s what’s actually selectable at install, and how to add Teams and Zoom optimization after the fact.
Adding a Workspace app component you skipped
The CWA installer’s optional components are things like Single Sign-On (SSON), Citrix Enterprise Browser, and (on older builds) App Protection — not Teams/Zoom. If you skipped one, you don’t have to uninstall:
- Re-run
CitrixWorkspaceApp.exeover the existing install — it lets you add components, or - Use the command line to add specific components (mandatory ones come along automatically):
CitrixWorkspaceApp.exe ADDLOCAL=ReceiverInside,ICA_Client,SSON,CitrixEnterpriseBrowser,WebHelper
Note: since CWA 2212, App Protection is installed by default, so
AppProtectionis no longer a validADDLOCALvalue (older builds used the/includeappprotectionswitch).
Microsoft Teams: enable the new (SlimCore) VDI optimization
Teams optimization is built into CWA + the Citrix VDA — there’s no Teams option in the CWA installer. Modern (“new”) Teams uses Microsoft’s SlimCore VDI engine, and the one step people miss is allow-listing its virtual channels on the VDA.
1. Meet the version floor. SlimCore needs minimum VDA 2203 LTSR CU3 (or 2305 CR) and CWA for Windows 2203 LTSR latest CU (or 2302 CR). The endpoint CWA installs a small VDI plugin DLL alongside itself that bootstraps the SlimCore media engine — no separate big installer.
2. Allow-list the three SlimCore virtual channels (the critical step). Since recent VDAs, the Virtual channel allow list policy is on by default, so any custom channel — including Teams SlimCore’s — must be added explicitly or optimization silently won’t engage:
-
In Citrix Studio → Policies, edit (or create) a policy and add the setting Virtual channel allow list.
-
Add these three entries — each is
channelname,process-path. The Teams path needs wildcards because it’s an MSIX app whose folder changes per version (wildcard support requires CVAD 2203 LTSR CU2+):MSTEAMS,C:\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe MSTEAM1,C:\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe MSTEAM2,C:\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe -
Apply the policy to the delivery group, then reboot the VDA machines — the allow-list change only takes effect after a reboot.
3. Verify. In Teams, open Settings → About (or the call-health view) — it should report the session is Citrix HDX optimized (SlimCore). If it still shows “not optimized,” the channels aren’t allow-listed (step 2) or the VDA wasn’t rebooted.
Heads-up on timing: the legacy WebRTC Teams optimization is on the way out (Microsoft’s end-of-support is October 1, 2026), so deploy the new SlimCore VDI optimization rather than the old path.
Zoom: install the matching Zoom VDI plugin
Zoom optimization is not part of CWA either. It’s a two-piece design:
- The Zoom VDI app runs on the virtual desktop (server side).
- The Zoom VDI plugin must be installed on the endpoint (the local PC/thin client) — it requires CWA to be present for the optimization to work.
The version rule (this is what trips people up): the endpoint plugin version must be equal to or lower than the Zoom VDI app version on the virtual desktop — a plugin newer than the host app is not supported.
To install it:
- Check the Zoom VDI app version on the virtual desktop (Zoom → profile → About).
- From Zoom’s VDI releases & downloads page, get the Windows VDI plugin at that version or lower (match the bitness of your endpoint OS).
- Install it on the endpoint (local PC/thin client) — CWA must already be present. For fleets, push it with your deployment tool.
- Reconnect and start a Zoom call; the in-meeting status should show it’s running in VDI/optimized mode.
In many environments the session itself prompts to download and install the plugin on the endpoint the first time — clicking through briefly disconnects the session to complete the install, then reconnects.
FAQ
I never saw a Teams/Zoom checkbox during install — did I do it wrong? No. Neither is a CWA install option. Teams is optimized by CWA+VDA (enable SlimCore as above); Zoom needs its separate VDI plugin on the endpoint.
Optimization isn’t kicking in for Teams. Usually the VDA-side virtual channels aren’t allow-listed in the Citrix policy (step 2), or the CWA version is too old for SlimCore. Confirm both, then recheck the in-app status.
Zoom call quality is poor / not optimized. Almost always a version mismatch — the endpoint plugin is newer than the VDI app, which isn’t supported. Match the plugin to (or below) the host Zoom VDI app version.
Sources: Citrix — Install and uninstall (ADDLOCAL components), Microsoft Learn — New VDI solution for Teams (SlimCore), Citrix — Microsoft SlimCore Optimization, Citrix — Virtual channel allow list, Zoom Support — VDI releases and downloads / managing the VDI plugin version