Configuring Session (Login Dialog)

The list on the left shows saved sites and workspaces. You should select from there a site, site folder, or workspace to work with before pressing one of the Login or Edit (sites only) buttons; or using Delete, Rename or other commands from the Manage menu button (also available from context menu).

Double-clicking a site or workspace opens it (as if you have clicked the Login button).

To open all sites in a site folder, select the folder and press the Login button.

If you have many sites, you can incrementally search for a site by typing part of its name. Then you can use Tab (or Shift-Tab) to search next (previous) matching sites. Press Esc to cancel searching. In the Incremental Search submenu of list context menu, you can select one of the search modes: Beginning of Site Name Only, Any Part of Site Name or All Major Site Fields (name, hostname, user name and note).

The sites can be organized into folders. Expand/collapse folder by double-clicking on its name.

Use the Manage > New folder command to create new site folder. To create subfolder, use path syntax “folder/subfolder” (Select the parent folder before pressing button to have the path prefilled). Note that empty folders are not preserved.

Use Edit button to start editing selected site. After you complete your changes, save them with Save button. You can also save a modified site under a new name using Save As command from drop-down menu of Save button.

Use Cancel button to rollback your changes.

Note that you cannot login to the site until you commit (or rollback) your changes.

If you want to change the same setting for many sites, you can use command-line parameter /batchsettings.

The Manage > Delete command (or Del key) deletes selected site, site folder or workspace. Deleting a site folder deletes all the sites it contains.

Use the Manage > Rename command to rename selected site, site folder or workspace.

Use Manage > Desktop Icon command to create a Desktop shortcut icons for selected site, site folder or workspace. For sites you can create also 'Send To’ shortcuts.

Note that if you delete the site the existing icons will not work anymore.

Use the Manage > Rename command to rename selected site, site folder or workspace.

Use Manage > Set Defaults set configured session settings or settings of selected site as default session settings.

Use the Manage > Paste Session URL or Ctrl+V to paste a session URL from the clipboard. It gets parsed into File protocol, Host name, Username, etc. The command is available only for New Site node or when editing site.

Use the Manage > Generate Session URL/Code to open Generate Session URL/Code dialog for selected site.

In addition to configuring the session, you can use the WinSCP Login dialog box to:

• Import sites from PuTTY or FileZilla;
• Import/Export configuration;
• Cleanup data stored on your computer by WinSCP;
• Run PuTTYgen or Pageant;
• Check for application updates (not available in Microsoft Store installation);
• Open Preferences dialog;
• Open About dialog.