This article is about importing transactions. If you are looking for information about importing account balance history, we have a separate article here: Upload account balance history
You can upload transactions to any Monarch account using a CSV file. Many banks and apps like Mint, Personal Capital or YNAB allow you to export transactions in the CSV format which you can use to import into Monarch.
Please Note: It is not possible to undo a CSV import. You will have to bulk delete transactions or delete the account and start over.
Once transactions are imported they are added to the cash flow reports and budgets just like transactions in a sync'd account.
Importing a Single Account
You can upload a CSV file for a single account on the account details page using the edit button in the top right:
There is also a button that has the option to Download transactions which is a great way to see the format required to import a CSV.
The required CSV format for importing and exporting is 7 columns:
- Original Statement
- Amount **
Please Note: Monarch uses positive numbers for income and negative numbers for expenses. So +$100 would be seen as income and -$100 would be seen as an expense. Some apps and banks export expenses as positive numbers which means they will show up incorrectly if imported directly into Monarch. You may need to play around with your CSV file to convert positive to negative numbers in this case.
Example Spreadsheet (.CSV)
Click here to download an example spreadsheet (.CSV) with example data that you can copy to make sure you are using the correct format.
Please Note: Only bank account and credit card transactions can be imported into Monarch. Holdings, budgets, or aggregate cash flow total can not be imported but many of them are derived from the underlying transactions once you import transactions. To learn how to import account balance history, read here.
Importing Multiple Accounts
If you have more than 1 account you would like to import or you are importing from Mint we recommend using the multi-account importer. It can be found in the "add account" screen:
The required format for the multi-account import is 9 columns.
Please Note: A "Mint field" is the same thing as a "Monarch field." All 9 of these columns must be in the file even if they are blank for the import to be successful.
- Date → Date
- Description → Merchant
- Original Description → Original Statement
- Amount → Amount
- Transaction Type → ignored since amounts are used instead to determine credit/debit
- Category → Category
- Account Name → Used to map the multiple accounts
- Labels → Tags
- Notes → Notes
Importing from Mint
Check out the article Move data over from Mint to Monarch for all the details about this workflow!