Open in the explorer

Session reliability and automatic reconnection

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › Network routing
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_ClientAutoReconnect_1

Explanation

"This policy configures client behaviour in case of network failure.

To set the reconnection to , select:

Enable automatic reconnection : In case of network failure, the client automatically attempts to reconnect to a server

Enable session reliability: In case of network failure, the client attempts reconnection to an SSL/TS server.

NOTE: If both Enable Automatic reconnection and Enable session reliability is selected, the client by default selects the option Enable session reliability in case of network failure.

NOTE: If this policy is enabled and none of the options are selected, the policy is not enforced.

Transparency Level: The transparency level applied to XA/XD session during session reconnection.

Setting 0 indicates that XA and XD will be turned to black window at the session reconnection.

Setting 100 indicates that no transparency layer will be applied (frozen screen)

Troubleshooting:
Some proxy servers automatically disconnect connections that are idle for a certain length of time. This can cause client sessions to be disconnected when not in use. A server-side option ""ICA Keep-Alive"" is available to send extra data packets during periods of inactivity that can be used prevent proxies from closing connections. "

Registry

HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Enable

# Enable: receiver/Policy_ClientAutoReconnect_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enable automatic reconnection
# unchecked: false
Set-ItemProperty -Path $k -Name 'TransportReconnectEnabled' -Value '*' -Type String
# Transparency Level
Set-ItemProperty -Path $k -Name 'NetDisruptBrightness' -Value '80' -Type String  # between 0 and 100
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGP'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enable session reliability (has precedence if both are selected)
# unchecked: 0.0.0.0
Set-ItemProperty -Path $k -Name 'CGPAddress' -Value '' -Type String

Disable

# Disable: receiver/Policy_ClientAutoReconnect_1
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_ClientAutoReconnect_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection'
Remove-ItemProperty -Path $k -Name 'TransportReconnectEnabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'NetDisruptBrightness' -ErrorAction SilentlyContinue
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGP'
Remove-ItemProperty -Path $k -Name 'CGPAddress' -ErrorAction SilentlyContinue

Options (3)

LabelControlRegistry valueREG typeConstraints / details
Enable automatic reconnectionPart_ClientAutoReconnect_ReconnectCheck boxbooleanTransportReconnectEnabledREG_SZ
Default (UI): true
Checked: REG_SZ = *
Unchecked: REG_SZ = false
Enable session reliability (has precedence if both are selected)Part_ClientAutoReconnect_CGPCheck boxbooleanCGPAddressin Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGPREG_SZ
Default (UI): true
Checked: REG_SZ = (empty string)
Unchecked: REG_SZ = 0.0.0.0
Transparency LevelPart_ClientAutoReconnect_DimmingNumeric boxdecimalNetDisruptBrightnessREG_SZ
Min: 0 · Max: 100 · Default (UI): 80

Application

Citrix Workspace app (Citrix) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.