Troubleshoot errors related to downloads
This section covers errors that occur while downloading the feed file.
They are related to file availability, network connectivity, server responses, pagination, or feed size.
These errors often indicate that the feed cannot be reached, does not exist at import time, or fails during transfer.
Error code | Error message | Potential reason | How to fix it |
|---|---|---|---|
RemoteFileNotFound | Remote file does not exist | Feed file missing at import time | Ensure the feed file is uploaded before the scheduled import. |
RemoteFileNotExists | File not found (404) | Incorrect file path or filename | Verify the exact path and filename (including case sensitivity). |
DownloadConfigurationError | Invalid download configuration | Feed format or configuration mismatch | Check that the feed format (CSV/XML/JSON) matches the configuration. |
DownloadError | Generic download failure | Feed URL invalid or unreachable | Test the feed URL manually and ensure it returns a file. |
VlookupDownloadError | Vlookup file not found or inaccessible | One or more configured vlookup (lookup) files are missing or not accessible at import time | Ensure all required vlookup files are present in your Criteo FTP directory and named exactly as expected. |
RemoteServiceUnavailable | Service unavailable (503) | Temporary server outage | Retry later or contact your hosting provider if the issue persists. |
FeedTooSmall | Feed is too small | Feed is empty or truncated | Open the feed URL and ensure it contains valid product data. |
CurleOperationTimedout | Download timed out | Slow or unstable server | Improve server response time or reduce feed size. |
OtherHttpError | HTTP error (4xx / 5xx) | Server‑side error | Fix the HTTP error returned by your server. |
GatewayTimeout | Gateway timeout (504) | Feed server takes too long to respond when downloading the file | Optimize your server performance or split the feed into smaller pieces and use the multipage feature to reduce download time. |
MultipageDownloadError | Multipage download inconsistency | One or more pages failed to download | Ensure all feed pages are accessible and consistent. |
MultipageUrlNoPlaceHolder | Pagination placeholder missing | Paginated feed not correctly configured | Add the required pagination placeholder {0} to the feed URL. |
CantDetectFileFormat | File format not recognized | Unsupported or corrupted file | Upload a valid CSV, XML, or JSON file. |
InvalidGzipFormat | Invalid gzip file | File is not actually compressed | Upload a valid gzip file or disable gzip in the configuration. |
SslConnectError | SSL/TLS connection error | Invalid SSL certificate | Ensure the SSL certificate is valid and up‑to‑date. |