Imports
Universal Format 2.0 lets any tool move data into FlowFast: a migration from another task tracker, a custom exporter, or a hand-made set of boards and cards. You describe the data as a package: plain JSON arrays of records, one entity per file, plus the files of the attachments. You import the package with Convertinator, which checks the whole package on your computer before it sends anything.
A package carries any of 32 entities, from boards and cards to documents, custom properties and access roles. It needs only the entities you have data for, and the records refer to each other by identifiers of your own.
What a package looks like
my-package/
├── meta-data.json the manifest: which file holds which entity
├── resources/
│ ├── boards.json a JSON array of records
│ ├── cards-0001.json an entity can be split into any number of files
│ ├── cards-0002.json
│ └── users.json
└── files/
└── report.txt the bytes of an attachmentThe Bundle format page describes every part of it.
How an import runs
- Build the package. Write
meta-data.json, the JSON files of every entity and the attachment files. The examples are a good start. - Open it in Convertinator. Sign in, choose the folder or the archive, the target space and the error-handling mode.
- Let it compile. Convertinator validates the package and prepares it on your computer. A problem is reported with the file, the number of the record and the field, and nothing is sent.
- Check it. The server can check the package first, without writing anything to the company (preflight).
- Import it. Start the import. The server writes the data, and you receive an email when it finishes.
Where to go next
- Bundle format: the manifest, files, references, history, limits and error codes.
- What you can import: what each entity is and what it needs.
- Convertinator: sign in, choose the package and the mode, check and import.
- Colors: how the colors of card types, tags and options are chosen.
- Entity map: every entity and the references between them, on one picture.
- Examples: ready packages to download, inspect and import.
The fields, types and references of every entity are on the pages of the Entities group in the menu. The earlier universal import format (meta-data.json with boards, cards and documents files) remains supported only until December 1, 2026. It is deprecated and must not be used for new integrations.
