Documentation » Configuration » Preferences Dialog » Integration »

The Applications Integration Page (Preferences Dialog)

The Applications Integration page on the Preferences dialog allows user to configure how WinSCP integrates with other applications, particularly with PuTTY or other terminal clients.


Refer to documentation of page sections:

External Applications

PuTTY/Terminal Client Path

Using PuTTY/Terminal client path box you can specify local path to PuTTY or other terminal client application that is used with Open in PuTTY function. You can also use Microsoft Store app aliases here, for example the wt.exe for Windows Terminal.

Optionally, you can use following patterns in the path:

Pattern Description
!! Is replaced with exclamation mark (!).
!/ Current remote path.
!@ Current session hostname.
!U Current session username.
!P Current session password (if stored or remembered).
!# Current session port number.
!K Current session private key.
!N Current session name.
!?prompt[\]?default! When used, user is prompted to enter value that replaces the pattern. prompt can define a message of the prompt and default a default value, both can be empty. Special characters entered by user are automatically delimited. You can prohibit this using optional backslash (\) before second question mark (?).
!`command` Replaced with output of given local console command.


If pattern !@ is not used, parameter -load <site> is automatically added to the command.

If pattern !P is not used, a password is known, and you are using an up-to-date version of PuTTY,1 the password is passed using named pipe and -pwfile switch. Otherwise insecure -pw <password> parameter is used.2

See also PuTTY command-line documentation.

Other Options

Check Remember session password and pass it to PuTTY checkbox to make WinSCP keep session password in memory and pass it to PuTTY when using Open in PuTTY function. However better approach would be to use public key authentication together with Pageant. The option is disabled, when the !P pattern is used in the terminal client path box, as it implies that the password is remembered.

By default WinSCP instructs PuTTY to open Telnet session if you are using FTP. Uncheck the Open Telnet sessions in PuTTY for FTP sessions to use SSH instead.3

Check Automatically open new sessions in PuTTY to automatically send all sessions opened in WinSCP also to PuTTY.

Use PuTTY registry key selection lets you choose registry key, where WinSCP exports its session settings, to be used by terminal client. WinSCP exports settings in PuTTY format, which is also used by many of its clones, such as KiTTY. If your terminal client does not support this format, you need to use respective patterns (i.e. !@ and !U) in terminal client path box as an alternative way to pass the settings. The registry key path is also used by WinSCP when importing sites. The option is not available in Microsoft Store installation, where WinSCP uses only command-line switches to pass a limited set of session settings to PuTTY.

Further Reading

  1. The executable name is putty.exe and its version is 0.77 or higher.Back
  2. It is passed as the first argument of the executable, before any custom arguments.Back
  3. However note that if the server supports SSH protocol, it most probably supports SFTP also. You should always use SFTP, instead of FTP, if possible.Back

Last modified: by martin