Main Content


Upload file or folder to SFTP or FTP server



mput(s,contents) uploads the files or folders specified by contents to the current folder on the SFTP or FTP server associated with s.

uploadPaths = mput(s,contents) returns a cell array that lists the paths to the uploaded files on the server.


collapse all

Connect to an FTP server and upload files from your local machine to the server. This example shows a hypothetical FTP session on, a machine that does not exist. If you have an account on an FTP server that grants you permission to upload files to that server, then you can use the mput function as shown in this example.

First, connect to the server.

s = ftp('')
FTP with properties:

                         Host: ""
                     Username: "anonymous"
                         Port: 21
                 ServerLocale: "en_GB"
                         Mode: "binary"
    LocalDataConnectionMethod: "passive"
       RemoteWorkingDirectory: "/"

Display the contents of the current folder on the FTP server.

myscript.m                  README.txt                pub    

Upload a file from your local machine to the FTP server.


Display the updated contents on the FTP server, including the new myNewScript.m file.

myscript.m                  myNewScript.m           README.txt

Upload multiple files. If the file names have some text in common, then you can use a wildcard character (*) to match the rest of the names. In this example, use a wildcard to match the file names image001.png, image002.png, and image003.png on your local machine.


Display the updated contents on the FTP server.

image001.png                image002.png            image003.png
myscript.m                  myNewScript.m           README.txt

Input Arguments

collapse all

Connection to an SFTP or FTP server, specified as an SFTP object or an FTP object.

Local files or folders, specified as a character vector or string scalar.

To match multiple files or folders on your local machine, you can include a wildcard character (*) in contents. For example, if you specify contents as *.docx, then mput uploads all files whose names end with .docx.

Version History

Introduced before R2006a

See Also

| | | |