Open in the explorer

Adaptive Gateway Selection

Type
Computer
GPO path
Computer 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_AdaptiveGatewaySelection

Explanation

Adaptive Gateway Selection enables Citrix Workspace app to automatically detect and connect to the best Citrix Gateway Service Point of Presence (PoP) based on current connection conditions.

If latency exceeds the Latency Threshold (expressed in milliseconds) for longer than the Latency Breach Duration (expressed in seconds), the app initiates a new Gateway Selection.

The Wi-Fi Signal Strength Threshold defines the minimum signal needed to perform a gateway selection (expressed as a percentage). If the signal falls below this level, gateway selection will not occur.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine
Value name
AdaptiveGatewaySelection_Enabled
StateValue written
EnabledREG_DWORD = 1
KeyValueData
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdHighLatencyREG_DWORD = 300
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdMinTimeREG_DWORD = 30
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdWifiSignalStrengthREG_DWORD = 30
DisabledREG_DWORD = 0
KeyValueData
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdHighLatencyDeletes the value
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdMinTimeDeletes the value
Software\Policies\Citrix\ICA Client\EngineAdaptiveGatewaySelection_ThresholdWifiSignalStrengthDeletes the value

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_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -Value 1 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord
# Latency Threshold
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord  # between 1 and 5000
# Latency Breach Duration
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord  # between 0 and 3600
# Wi-Fi Signal Strength Threshold
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord  # between 0 and 100

Disable

# Disable: receiver/Policy_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -Value 0 -Type DWord
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -ErrorAction SilentlyContinue

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -ErrorAction SilentlyContinue

Options (3)

LabelControlRegistry valueREG typeConstraints / details
Latency ThresholdAdaptiveGatewaySelection_ThresholdHighLatencyNumeric boxdecimalAdaptiveGatewaySelection_ThresholdHighLatencyREG_DWORD
Required · Min: 1 · Max: 5000 · Default (UI): 300
Latency Breach DurationAdaptiveGatewaySelection_ThresholdMinTimeNumeric boxdecimalAdaptiveGatewaySelection_ThresholdMinTimeREG_DWORD
Required · Min: 0 · Max: 3600 · Default (UI): 30
Wi-Fi Signal Strength ThresholdAdaptiveGatewaySelection_ThresholdWifiSignalStrengthNumeric boxdecimalAdaptiveGatewaySelection_ThresholdWifiSignalStrengthREG_DWORD
Required · Min: 0 · Max: 100 · Default (UI): 30

Application

Citrix Workspace app (Citrix) — October 2026 templates

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