Group Policy

Group Policy Object administrative template

We recommend that you use the Group Policy Object administrative template to configure rules for:

  • Network routing
  • Proxy servers
  • Trusted server configuration
  • User routing
  • Remote user devices
  • User experience

You can use the receiver.admx / receiver.adml template files with domain policies and local computer policies. For domain policies, import the template file using the Group Policy Management console. Importing is useful when applying Citrix Workspace app settings to several different user devices throughout the enterprise. To modify on a single user device, import the template file using the local Group Policy Editor on the device.

Citrix recommends using the Windows Group Policy Object (GPO) administrative template to configure Citrix Workspace app.

The installation directory includes CitrixBase.admx and CitrixBase.adml, and, administrative template files (receiver.adml or receiver.admx`receiver.adml`).


The .admx and .adml files are for use with Windows version mentioned in the Compatibility matrix.

If Citrix Workspace app is installed with VDA, the ADMX/ADML files are typically found in the \<installation directory>\Online Plugin\Configuration directory.

If Citrix Workspace app is installed without the VDA, the ADMX/ADML files can be typically found in the following directory.

  • For 64-bit: C:\Program Files (x86)\Citrix\ICA Client\Configuration directory
  • For 32-bit: C:\Program Files\Citrix\ICA Client\\Configuration directory

See the following table for information about Citrix Workspace app template files and their respective locations.


Citrix recommends that you use the GPO template files provided with latest version of Citrix Workspace app.

File type File location
receiver.adm \ICA Client\Configuration
receiver.admx \ICA Client\Configuration
receiver.adml \ICA Client\Configuration\[MUIculture]
CitrixBase.admx \ICA Client\Configuration
CitrixBase.adml \ICA Client\Configuration\[MUIculture]


  • If the CitrixBase.admx\adml isn’t added to the local GPO, the Enable ICA File Signing policy might be lost.
  • When upgrading Citrix Workspace app, add the latest template files to local GPO. Earlier settings are retained after import. For more information, see the following procedure:

To add the receiver.admx/adml template files to the local GPO:

You can use .adm template files to configure both the Local and the domain-based GPO. Refer to the Microsoft MSDN article about managing ADMX files here.

After installing Citrix Workspace app, copy the following template files:

File type Copy from Copy to
receiver.admx Installation Directory\ICA Client\Configuration\receiver.admx %systemroot%\policyDefinitions
CitrixBase.admx Installation Directory\ICA Client\Configuration\CitrixBase.admx %systemroot%\policyDefinitions
receiver.adml Installation Directory\ICA Client\Configuration\[MUIculture]receiver.adml %systemroot%\policyDefinitions\[MUIculture]
CitrixBase.adml Installation Directory\ICA Client\Configuration\[MUIculture]\CitrixBase.adml %systemroot%\policyDefinitions\[MUIculture]


Add the CitrixBase.admx/CitrixBase.adml to the \PolicyDefinitions folder to view the template files in Administrative Templates > Citrix Components > Citrix Workspace.

Group Policy