This is an old revision of the document!

Documentation » Using WinSCP » Basic Tasks »

Uploading Files

This article contains detailed description of uploading files. You may want to see simplified guide to the process instead.

Advertisement

Using Drag&drop (Mouse)

First select the local files or directories you want to upload. You can select the files in the Windows Explorer or other application. If you are using Commander interface, you can also select the files in its local panel.

Then drag your selection and drop it on the remote panel. If you drop the files on empty place on file list, the files will be uploaded to current remote directory1. If you drop the files on remote directory icon (either in the file list or directory tree), the files will be uploaded to that directory.

Before the upload actually starts, the transfer options dialog will show. There you will have a chance to change the transfer options or the target directory. You can avoid the dialog being shown in preferences. In such case you can change the transfer options by selecting preset on Transfer Settings toolbar.

If you hold Shift key while dragging the files, they will be moved to remote directory (i.e. transferred and deleted from local directory).

You can also drop files to session tab to upload them using non-active session.

Using Keyboard

If you prefer controlling application using keyboard, you will probably find Commander interface useful. Otherwise, you must use copy&paste method.

First select the local files or directories you want to upload (learn how to select files using keyboard). Make sure that local panel is still active and use command Files > Copy (or press F5 key).

Before the upload actually starts, the transfer options dialog will show. There you will have a chance to change the transfer options or the target directory. The target directory is by default the current remote directory. You can avoid the dialog being shown in preferences. In such case you can change the transfer options by selecting preset on Transfer Settings toolbar.

Advertisement

If you use Files > Move (or press F6 key), the files will be moved to remote directory (i.e. transferred and deleted from local directory).

Using Copy&paste

If you prefer the Explorer interface, but still want to control it using keyboard, you need to use copy&paste method.

First select the files you want to upload in Windows Explorer or other application and copy them to clipboard.

Then switch to WinSCP and use command File(s) > Paste (or Ctrl+V).

Before the upload actually starts, the transfer options dialog will show. There you will have a chance to change the transfer options or the target directory. The target directory is by default the current remote directory.

Note that if clipboard contains plain text string only (no file data), the function File(s) > Paste opens the path stored in clipboard instead of pasting files.

Using Windows Explorer’s ‘Send To’ Context Menu

Learn how to integrate WinSCP into Windows Explorer’s ‘Send To’ menu.

Dropping Files on WinSCP Icon

Files dropped on WinSCP icon associated with stored session will be uploaded.

Dropping Files on Session Tab

To upload files using different session than active one, you can drop the local files to any session tab.

File Upload on Background

By default, the file upload starts on foreground, blocking the WinSCP window until it is complete. Learn how to schedule the background transfer.

Preserving Overwritten Remote Files

You can set up remote recycle bin to backup files that you overwrite during upload.

Automating Upload

To automate file upload use scripting command put or .NET assembly method Session.PutFiles.

Upload/Download Buttons

In Commander interface you can use toolbar with Upload/Download buttons to transfer files. You will want to use these particularly, if you want to transfer files, without having the panel with source directory active.

Advertisement

Uploading Files From UNC Paths (Network shares)

While WinSCP cannot browse UNC paths (network shares) in local panel of Commander interface, it can upload files from there. You can drag the files from Windows Explorer or another application, you can use UNC paths in scripting, or use any other mean of uploading as described on this page.

  1. In Commander interface you may consider turning off Full row select option to be able to drop files everywhere except directory files names to upload then to current remote directoryBack

Last modified: by Petr