Skip to main content
All CollectionsAdding and Managing Costs in SubstlyImporting financial data
🧾 File requirements for card and bank statement uploads
🧾 File requirements for card and bank statement uploads

This article tells you how your exported list of transactions should look for you to be able to upload them to Substly.

Olle Stigenius avatar
Written by Olle Stigenius
Updated over 2 weeks ago

Format of the file

The file with the transactions needs to be in a text-based format (.csv) for Substly to be able to read and analyse the data.

Most banks and credit card issuers allow you to export statements in a text-based format directly from their internet bank. Get in touch with your bank if you need help with how you export data from them.

If there is a choice to export "additional data", "all details" or similar, make sure to check that box and export all information about the transactions. If you don't, some banks/card issuers will not export all the data needed to identify the vendors/services.


Content in the file

As a minimum, the transactions file needs to contain the following columns with information:

  • date: the date of the payment (the date formatting needs to be YYYY-MM-DD).

  • description: this field contains information about the transaction needed to identify the service or vendor. It is always present in an exported statement but is named differently from bank to bank. This field is sometimes called: text, recipient or similar.

  • amount: the amount of the payment.

Optional columns to add to your file if you want Substly to automatically map more transactions or to be able to see your payments in the currency they were charged.

  • message: this field also contains information about the transaction needed to identify the service or vendor. It is normally excluded in an exported file if you don't ask for "additional data", "all details" etc. Without this field, Substly will only be able to map up a part of your services and costs. This field is sometimes called: place of purchase, vendor or similar.

  • currency: the currency in which a charge was made (USD, EUR, SEK etc).


Link to an example .csv file (containing the same data as the picture below)

file-import-for-help-center-article
Did this answer your question?