> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape/configuring-sftp-connections/valid-ftp-commands/list-ftp-command.md).

# list (FTP command)

### Overview

The `list` command lists files in a given directory. The listing is loaded into the flow as a payload (where each filename is listed in an array).

## Need to know

Regular expressions are not supported for the `list` command - it should only be used to list all files in a given directory. If you need to work with a specific group of files, you may find the [get](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape/configuring-sftp-connections/valid-ftp-commands/get-ftp-command.md) command useful.

## Connection settings

When [configuring an SFTP connector](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape/configuring-sftp-connections.md), two fields should be updated:

| FTP command              | Root                                                                                                                                                    | Path          |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| FTP command only: `list` | <p>The root to the directory you want to list.<br><br>Since there is no specific file to consider, the full path to the directory will be the root.</p> | Not required. |

## Example

* [Scenario](#scenario)
* [The steps](#the-steps)

### Scenario

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><p>Our process flow is configured as follows:</p><p><img src="/files/VhqQ8VwgKjHCppRdPFwn" alt="" data-size="original"></p></td><td><a href="/files/rI8jPerjv9MFfSCvdBbq">/files/rI8jPerjv9MFfSCvdBbq</a></td></tr><tr><td>In this flow, we need to list all files in <code>/myfiles/folderB</code> on the remote server:<br><br><img src="/files/GC00ijtgLvdw7fcSl8pU" alt=""></td><td><a href="/files/2vpVY6Q37YrYqTgeZirK">/files/2vpVY6Q37YrYqTgeZirK</a></td></tr></tbody></table>

### The steps

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><p><strong>Connector settings</strong></p><p>Our SFTP shape is configured as follows:</p><p><img src="/files/BuHGcIEH2VOfTPTQj8Pn" alt="" data-size="original"></p><ul><li>List all files in the <code>root</code>, which is defined as: <code>/myfiles/folderB/</code></li></ul></td><td><a href="/files/oMb9sRQ3X0NcUlY4i8Mk">/files/oMb9sRQ3X0NcUlY4i8Mk</a></td></tr><tr><td>On our remote server, all files in <code>/myfiles/folderB/</code> are loaded into the flow as a payload, with files in an array:<br><br><img src="/files/yra3dq5yjsgHej5t13TO" alt=""></td><td><a href="/files/J6YFhcQQMgUmK2sBQwdu">/files/J6YFhcQQMgUmK2sBQwdu</a></td></tr></tbody></table>