task_upload » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| task_upload 2008-06-05 | task_upload 2024-05-14 (current) | ||
| Line 1: | Line 1: | ||
| ====== Uploading Files ====== | ====== Uploading Files ====== | ||
| + | //This article contains detailed description of uploading files. You may want to see [[guide_upload|simplified guide]] to the process instead.// | ||
| + | |||
| + | The simplest way to upload files is to drag them from local panel or Windows File Explorer to [[ui_file_panel|remote panel]] of WinSCP. See section [[#dragdrop|Using Drag&drop (Mouse)]]. | ||
| + | |||
| + | For alternative ways, advanced options and automation see further sections. | ||
| ===== [[dragdrop]] Using Drag&drop (Mouse) ===== | ===== [[dragdrop]] Using Drag&drop (Mouse) ===== | ||
| - | First [[ui_file_panel#selecting_files|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 [[ui_commander|Commander interface]], you can also select the files in its [[ui_file_panel|local panel]]. | + | First [[ui_file_panel#selecting_files|select the local files or directories]] you want to upload. You can select the files in the Windows File Explorer or other application. If you are using [[ui_commander|Commander interface]], you can also select the files in its [[ui_file_panel|local panel]]. |
| - | Then drag your selection and drop it on the [[ui_file_panel|remote panel]]. If you drop the files on empty place on file list, the files will be uploaded to current remote directory. 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. | + | Then drag your selection and drop it on the [[ui_file_panel|remote panel]]. If you drop the files on empty place on file list, the files will be uploaded to current remote directory.((In [[ui_commander|Commander interface]] you may consider turning off //[[ui_pref_commander#panels|Full row select]]// option to be able to drop files everywhere except directory files names to upload them to current remote directory.)) 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 [[ui_copy|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 [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer_settings_presets|Transfer Settings toolbar]]//. | + | &screenshotpict(upload_dragdrop) |
| + | |||
| + | Before the upload actually starts, the [[ui_copy|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 [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer|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_tab|drop files to session tab]] to upload them using non-active session. | ||
| ===== Using Keyboard ===== | ===== Using Keyboard ===== | ||
| - | If you prefer controlling application using keyboard, you will probably find [[ui_commander|Commander interface]] useful. Otherwise, you must use [[task_upload#using_copy_amp:paste|copy&paste]] method. | + | If you prefer controlling application using keyboard, you will probably find [[ui_commander|Commander interface]] useful. Otherwise, you must use [[#copy_paste|copy&paste]] method. |
| - | First select the local files or directories you want to upload (learn how to [[ui_commander#selecting_files|select files using keyboard]]). Make sure that [[ui_file_panel|local panel]] is still active and use command //Files > Copy// (or press ''F5'' key). | + | First select the local files or directories you want to upload (learn how to [[ui_commander#selecting_files|select files using keyboard]]). Make sure that [[ui_file_panel|local panel]] is still active and use command //Files > Upload// or press ''F5'' key. |
| - | Before the upload actually starts, the [[ui_copy|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 [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer_settings_presets|Transfer Settings toolbar]]//. | + | Before the upload actually starts, the [[ui_copy|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 [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer|Transfer Settings toolbar]]//. |
| + | |||
| + | If you use //Files > Upload > Upload and Delete// (or press ''F6'' key), the files will be moved to remote directory (i.e. transferred and deleted from local directory). | ||
| ===== [[copy_paste]] Using Copy&paste ===== | ===== [[copy_paste]] Using Copy&paste ===== | ||
| - | If you prefer the [[ui_explorer|Explorer interface]], but still want to control it using keyboard, you need to use copy&paste method. | + | If you prefer the [[ui_explorer|Explorer interface]], but still want to control it using keyboard, you need to use [[clipboard|copy&paste method]]. |
| - | First select the files you want to upload in Windows Explorer or other application and copy them to clipboard. | + | First select the files you want to upload in Windows File Explorer or other application and copy them to clipboard. |
| - | Then switch to WinSCP and use command //File(s) > Paste// (or ''Ctrl+V''). | + | Then switch to WinSCP and use command //Files > Paste// (or ''Ctrl+V''). |
| - | Before the upload actually starts, the [[ui_copy|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. | + | Before the upload actually starts, the [[ui_copy|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 disable the dialog in [[ui_pref_environment|preferences]]. |
| - | Note that if clipboard contains plain text string only (no file data), the function //File(s) > Paste// [[task_navigate#opening_path_stored_in_clipboard|opens the path stored in clipboard]] instead of pasting files. | + | ===== Using Windows File Explorer's 'Send To' Context Menu ===== |
| - | ===== Using Windows Explorer's 'Send To' Context Menu ===== | + | Learn how to [[integration#send_to|integrate WinSCP into Windows File Explorer's 'Send To' menu]]. |
| - | + | ||
| - | Learn how to [[integration#send_to|integrate WinSCP into Windows Explorer's 'Send To' menu]]. | + | |
| ===== Dropping Files on WinSCP Icon ===== | ===== Dropping Files on WinSCP Icon ===== | ||
| - | Files dropped on [[integration#icons|WinSCP icon]] associated with stored session will be uploaded. | + | Files dropped on [[integration#icons|WinSCP icon]] associated with [[session_configuration#site|site]] will be uploaded. |
| - | ===== Upload on Background ===== | + | ===== [[drop_tab]] Dropping Files on Session Tab ===== |
| - | By default, the upload starts on foreground, blocking the WinSCP window until it is complete. Learn how to schedule the [[transfer_queue|background transfer]]. | + | |
| - | ===== Preserving Overwritten Remote Files ===== | + | To upload files using different session than active one, you can drop the local files to any [[ui_tabs|session tab]]. |
| - | You can set up [[ui_login_environment#recycle_bin|remote recycle bin]] to backup files that you overwrite during upload. | + | |
| - | ===== Automating Upload ===== | + | ===== File Upload on Background ===== |
| - | To automate file upload use scripting command ''[[script_commands#put|put]]''. | + | By default, the file upload starts on foreground, blocking the WinSCP window until it is complete. Learn how to schedule the [[transfer_queue|background transfer]]. |
| + | |||
| + | ===== Preserving Overwritten Remote Files ===== | ||
| + | You can set up [[ui_login_recycle_bin|remote recycle bin]] to backup files that you overwrite during upload. | ||
| - | ===== Upload/Download Buttons ===== | + | ===== Automating Uploads ===== |
| - | In [[ui_commander|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 [[ui_file_panel|panel]] with source directory active. | + | To automate file upload use scripting command ''[[scriptcommand_put|put]]'' or .NET assembly method ''[[library_session_putfiles|Session.PutFiles]]''. |
| - | ===== [[unc]] Uploading Files From UNC Paths (Network shares) ===== | ||
| - | While WinSCP cannot browse UNC paths (network shares) in local [[ui_file_panel|panel]] of [[ui_commander|Commander interface]], it can upload files from there. You can [[task_upload#dragdrop|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. | ||