Skip to content

Firefly III Data Importer documentation

Welcome to the documentation of the Firefly III Data Importer, the nr. 1 tool to import data into Firefly III.


This data importer is a universal importer, which means it can import from any sources you can think of. And if it can't, well then drop me a line and make me add your favorite data source.

The data import supports a variety of sources:

  • You can import CSV files from any source: your bank, YNAB, Tiller or any other source of financial data.
  • You can import from your bank directly using a secure connection.

Because it is very difficult for a poor open source developer like me to build custom-made secure connections to every single bank out there, I've called in the help from two companies that already solved that enigma. They cannot get enough credit:

If those institutes do not support your financial institution, be sure you can still import CSV files. Other formats are still on the roadmap. That should cover your needs.


Read more about Salt Edge / Spectre and Nordigen before you use their services.


The Firefly III Data Importer (or FIDI for short) is a tool you need to install next to Firefly III itself. Several options are available:


To use FIDI, you need any of the following things:

  • API keys from Salt Edge / Spectre, if you want to use their services. Check out the guidelines.
  • API keys from Nordigen, if you want to use their services instead. Check out the guidelines

If you wish to use neither, you need a CSV file from your bank. How and where you download it depends on the bank entirely.

JSON file

Optionally, FIDI accepts a JSON file with import configuration values.

And then what?

Your transactions can be messy and confusing once imported. It can also be difficult to import a lot of data at once. Be sure to read the page 🐤 My First Import.

Last update: 2023-01-29