How to check if my FTP/SFTP connection is working?
To check whether your FTP or SFTP connection is working, test the same credentials in FileZilla first, then confirm the path and filename, then run the connection test in Stock Sync. Use this checklist when a feed fails to connect or loads no data.
How to Check Your FTP/SFTP Connection
- Test the credentials in FileZilla: Enter the same host, username, password, and port. If FileZilla returns "Authentication failed" or "Please check username & password," the credentials are incorrect and must be confirmed with your supplier.
- Confirm the path and filename: Make sure the filename and folder path match exactly what is on the FTP server. Filenames are case-sensitive, so
CO0040StoCK.csvis different fromCO0040Stock.csv. - Confirm the file exists: If you receive a "ftp_file_not_found" error, compare the feed's configured path with the actual server directory.
- Run the connection test in Stock Sync: Once corrected, click Test Connection in Step 1 to confirm the connection.
- Check File Listing and Load Source: If File Listing succeeds but Load Source fails, the connection works but Stock Sync cannot download the file. Ask the FTP owner to confirm the server returns directory listings and allows file downloads, and verify the exact directory and filename.
ftp.example.com or an IP), without http:// or folder paths.For FTP, the default port is usually 21. Some servers require encryption set to Plain FTP.Stock Sync cannot read files stored on a local hard drive. Files must be hosted on a server or cloud storage.Additional Notes
- Zero items updated: If the file loads but returns zero updated items, check whether the file format is valid. Malformed structures, such as CSV wrapped in square brackets, may need correction by the supplier.
- Firewall restrictions: If your server uses a firewall, whitelist Stock Sync's static IP 52.20.189.51. If the connection works locally but fails from Stock Sync, the server firewall is likely blocking the request.
- Timeouts: If the connection times out even after whitelisting, ask the server owner to check the firewall or security settings. If it also times out in FileZilla, the issue is likely on the server side.
- Dynamic filenames: Some servers require the exact filename. Date-based filenames cannot be fetched unless the full filename is provided.
- "No files found" message: Confirm that the SFTP folder is not empty and that the expected file has been uploaded.
- Free plan: FTP access is disabled on the Free plan, so FTP feeds will not work unless the plan includes Update Feed.
For FileZilla usage instructions, see FileZilla basic usage instructions.
Troubleshooting Steps
- Issue: Authentication failed or incorrect username/password → Solution: Confirm the credentials in FileZilla, then check with your supplier that the account is active.
- Issue: File not found (
ftp_file_not_found) → Solution: Match the directory and filename exactly, including case, to what exists on the server. - Issue: Connection works in FileZilla but not in Stock Sync → Solution: Whitelist 52.20.189.51 on the server and confirm the protocol (FTP, SFTP, or FTPS) and port.
- Issue: File loads but zero items are updated → Solution: Ask the supplier to confirm the file is valid and not wrapped in extra characters such as square brackets.
Good Articles to Continue
- FTP - Download connection method → Step-by-step setup for the FTP connection in Feed Manager.
- SFTP connection method → Setup and common errors for SFTP connections.
- What is Feed Manager (Step 1) ? → Overview of connection methods and file formats.
Updated on: 13/11/2026
Thank you!
