- Check that Clarus received it and whether it processed or failed.
- See every attempt to process it, with how many records it imported.
- View the errors behind a failed attempt in plain language.
- Retry a failed file once you have fixed the cause. You don’t need to send the file again.
- Download the file exactly as Clarus received it, to check what the sender actually sent.
Clarus keeps a copy of each file for 15 days after it arrives. The Available Until column shows when a file’s copy expires. After that date you can no longer download or retry the file.
Before you start
- To see the page and its files, your role needs the Import Files ability with Read access. With Read access only, the Download, Upload and Retry buttons are disabled.
- To download, upload or retry files, your role needs Manage access as well. The Admin role has both by default. See User roles.
- Uploading and retrying need an import configuration, which tells Clarus how to read the file. If your files have no import configuration yet, contact Clarus support. See Bespoke Imports.
Find your file
Each row is one file. The newest files are at the top.
Use the filters and column options to find a file by name, date or status. See Customising Data Grids.
File statuses
See why a file failed
1
Open the file
Click Show on the file’s row. The General section shows where the file came from and how long it is kept.
2
Find the failed attempt
The Attempts section lists every time Clarus has processed the file, newest first. It shows each attempt’s status, the import configuration used, the number of Imported Records, who ran it and when.
3
View the errors
Click View Errors on the attempt. The Import Errors window lists each problem in plain language, for example Product not found (Code: ABC123). When the same problem affects several lines, it is listed once with the number of times it happened.Expand Details to see the full technical error. This is useful if you need to contact support.
Retry a failed file
Most failures are caused by reference data that doesn’t exist in Clarus yet, such as a new product or a delivery address that isn’t set up. Fix the data in Clarus, then retry the file. You don’t need to resend it.1
Fix the cause
Use the errors to find what is missing or wrong. For example, create the missing product.
2
Open the file and click Retry
Retry is available when the file’s status is Failed or Uploaded and its copy is still available.
3
Choose the import configuration
The sidebar selects the import configuration used last time. Change it if you need to, then click Retry.
4
Check the result
The file is queued for processing, and a new attempt appears in the Attempts section. Records created by the retry are recorded against your user.
Download a file
Click Download on the file’s row, or open the file and click Download at the top of the page. You get the file exactly as Clarus received it. Use it to check what a sender actually sent when someone queries the data. You can also use it to get a sample file during testing.If the button is disabled, the file’s copy has passed its Available Until date, or your role doesn’t have Manage access to Import Files.
Upload a corrected file
You can upload a file on the same page instead of sending it over SFTP. Use it to send a corrected file after a failure, or for a one-off import or initial data load when you haven’t set up an SFTP connection yet.1
Click Upload
Click Upload at the bottom of the Import Files list.
2
Choose the file
Select a file of up to 1 MB.
3
Choose an import configuration (optional)
To process the file straight away, select the Import Configuration to use. To keep the file for later, leave it empty. The file is saved with the status Uploaded, and you can process it later with Retry.
4
Click Upload
The file appears in the list with the source UI Upload. If you chose a configuration, it is queued for processing.
Can I retry a file that processed successfully?
Can I retry a file that processed successfully?
No. Only Failed and Uploaded files can be retried, so a successful file can’t be imported twice by mistake. You can still download it.
Why can't I find an older file?
Why can't I find an older file?
Clarus keeps each file for 15 days. Files that arrived before the Import Files page was introduced aren’t listed.
My file is larger than 1 MB. How do I import it?
My file is larger than 1 MB. How do I import it?
The 1 MB limit only applies to uploads in the web app. Send larger files over SFTP, or split the file into smaller files. See SFTP Overview.
Does uploading in the web app replace SFTP?
Does uploading in the web app replace SFTP?
No. For regular, automated imports from another system, SFTP is still the best option. Uploading in the web app is for files you send by hand. Files from both routes appear in the same list.

