Add Teams & Zoom Optimization to Citrix Workspace (If You Skipped It at Install)

Current Citrix Workspace app (CWA) Windows installers offer Microsoft Teams VDI Plugin and Zoom VDI Plugin choices on the administrator Add-on(s) page. Teams is selected by default from 2508, Zoom from 2511; previous selections can persist during upgrades. Older builds and other install channels differ. Here’s how to add a skipped plugin and check the server-side requirements.

Adding a Workspace app component you skipped

Re-run the supported CitrixWorkspaceApp.exe installer as an administrator and select the required add-on. Allow access to the third-party download servers. The Microsoft Store installation does not support these third-party plugin components. From CWA 2511, Citrix Enterprise Browser is a separate download rather than a bundled component.

For a Teams plugin previously deselected, Citrix documents this upgrade command:

CitrixWorkspaceApp.exe /InstallMSTeamsPlugin=Y

Note: since CWA 2212, App Protection is installed by default, so AppProtection is no longer a valid ADDLOCAL value (older builds used the /includeappprotection switch).

Microsoft Teams: enable the new (SlimCore) VDI optimization

Teams SlimCore optimization needs a supported CWA endpoint plugin, Citrix VDA, and server-side configuration. Installing the plugin alone does not configure the VDA’s virtual-channel policy.

1. Check current compatibility. Microsoft’s matrix lists VDA 2203 LTSR CU3 / 2305 CR and eligible CWA 2203 LTSR / 2402 LTSR / 2302 CR versions as floors, but only CWA versions still in vendor support are supported. Confirm the required Teams and endpoint-plugin versions too. The small endpoint VDI plugin DLL bootstraps the SlimCore media engine; older CWA builds may need a separately deployed plugin.

2. Check the three SlimCore virtual channels. The Virtual channel allow list is enabled by default from CVAD 2203. Where the channels are not already allowed, configure them explicitly. VDA 2603 and later allow these three channels by default, so confirm the effective policy before adding unnecessary entries:

1. In Citrix Studio → Policies, edit (or create) a policy and add the setting Virtual channel allow list.

2. 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

3. 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.

Microsoft’s legacy WebRTC Teams optimization reached end of support on October 1, 2026. Use the supported SlimCore VDI solution and check its current compatibility matrix.

Zoom: install the matching Zoom VDI plugin

Zoom remains a two-piece design even when CWA’s installer supplies the endpoint plugin:

• 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:

1. Check the Zoom VDI app version on the virtual desktop (Zoom → profile → About).
2. From Zoom’s VDI releases & downloads page, get the Windows VDI plugin at that version or lower (match the bitness of your endpoint OS).
3. Install it on the endpoint (local PC/thin client) — CWA must already be present. For fleets, push it with your deployment tool.
4. 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? Check the CWA version, install channel and administrator privileges. Current standalone administrator installs provide both options; the Microsoft Store build does not support these add-ons. Re-run the supported installer or have IT deploy the required endpoint plugin.

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