Citrix Receiver for Windows 4.12

Configuring the Group Policy Object administrative template

Citrix recommends using the Windows Group Policy Object (GPO)Editor to configure Citrix Receiver for Windows. Citrix Receiver for Windows includes administrative template files (receiver.adm or receiver.admx\receiver.adml -depending on the Operating System) in the installation directory.


  • Starting with Citrix Receiver for Windows Version 4.6, the installation directory includes CitrixBase.admx and CitrixBase.adml files.
  • Citrix recommends that you use the CitrixBase.admx and CitrixBase.adml files to ensure that the options are correctly organized and displayed within the Group Policy Object Editor.
  • The .adm file is for use with Windows XP Embedded platforms only. The .admx/.adml files are for use with Windows Vista/Windows Server 2008 and all later versions of Windows.
  • If Citrix Receiver for Windows is installed with VDA, admx/adml files are found in the Citrix Receiver for Windows installation directory. For example: <installation directory>\Online Plugin\Configuration.
  • If Citrix Receiver for Windows is installed without VDA, the admx/adml files are typically found in the C:\Program Files\Citrix\ICA Client\Configuration directory.

See the table below for information on Citrix Receiver for Windows templates files and their respective location.


Citrix recommends that you use the GPO template files provided with latest Citrix Receiver for Windows.

File Type File Location
receiver.adm <Installation Directory>\ICA Client\Configuration
receiver.admx <Installation Directory>\ICA Client\Configuration
receiver.adml <Installation Directory>\ICA Client\Configuration\[MUIculture]
CitrixBase.admx <Installation Directory>\ICA Client\Configuration
CitrixBase.adml <Installation Directory>\ICA Client\Configuration\[MUIculture]


  • If the CitrixBase.admx\adml is not added to the local GPO, the Enable ICA File Signing policy might be lost.
  • When upgrading Citrix Receiver for Windows, you must add the latest template files to local GPO as explained in the procedure below. While importing the latest files, previous settings are retained.

To add the receiver.adm template file to the local GPO (Windows XP Embedded Operating system only)


You can use .adm template files to configure Local GPO and/or Domain-Based GPO.

  1. Open the Citrix Receiver Group Policy Object administrative template by running gpedit.msc.
  2. In the left pane of the Group Policy Editor, select the Administrative Templates folder.
  3. From the Action menu, choose Add/Remove Templates.
  4. Select Add and browse to the template file location <Installation Directory>\ICA Client\Configuration\receiver.adm.
  5. Select Open to add the template and then Close to return to the Group Policy Editor. Citrix Receiver for window template file will be available on local GPO in path Administrative Templates > Classic Administrative Templates (ADM) > Citrix Components > Citrix Receiver.

After the .adm template files are added to the local GPO, the following message is displayed: “The following entry in the [strings] section is too long and has been truncated: Click OK to ignore the message.

To add the receiver.admx/adml template files to the local GPO (later versions of Windows Operating System)


You can use admx/adml template files to configure Local GPO and/or Domain-Based GPO. Refer Microsoft MSDN article on managing ADMX files.

After installing Citrix Receiver for Windows, copy the template files as given in the table below:

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]


Citrix Receiver for Window template files are available on local GPO in Administrative Templates > Citrix Components > Citrix Receiver folder only when the user adds the CitrixBase.admx/CitrixBase.adml to the \ policyDefinitions folder.