Move from Bonsai to Hourbun
By Fred Wu, maker of Hourbun · Checked · Report a mistake
The short answer
Export your Bonsai time as CSV: open the profile icon, Company Settings, Data, then Download Data CSV, and choose Time Tracked. In Hourbun, open Settings, Import, choose Another app (CSV) and upload the file: Hourbun proposes a column for each field, matches each person to a teammate and shows a preview before it imports anything.
Export your time from Bonsai#
- In Bonsai, open the profile icon at the top left, then Company Settings.
- Open Data, then Download Data CSV.
- Choose Time Tracked, and save the file. Each download is one type of data.
The same page downloads Invoices, Projects, Tasks, Expenses, Companies and Company Addresses, each as a CSV file of its own.
Import the file into Hourbun#
- Open the import. In Hourbun, open Settings, then the tab Import, and choose Another app (CSV) under "Import from".
- Upload the file. Drop the
.csvfile on the field, or use Choose files, then press Read the file. The field takes.csvfiles, or one.zipfile of them: save an Excel file as CSV first. Hourbun reads a file in UTF-8, with a comma, a semicolon or a tab between the columns. - Check the columns. Hourbun proposes a column of the file for each field. The Date, the Project and the Hours are required; a file with no hours can give a Start time and an End time of the same day instead. Check the formats of the dates and the hours (decimals,
H:MMorH:MM:SS), and choose a client for the rows with no client. The preview shows the first 5 rows as Hourbun reads them, and marks a value that it cannot read. - Choose what comes. An Import from date leaves out the rows before it.
- Match the people. Choose the teammate of each person of the file: you, a teammate of the workspace, or a new teammate with an email address. A new teammate is not invited and gets no email.
- Check the file. Press Check the file. Hourbun runs the whole import and rolls it back, then shows the preview: what comes over, the money check and what needs you. A Must fix item stops the import: correct the file, then upload it again.
- Import. Press Import and confirm.
The columns to check#
Bonsai's help does not list the exact column names of its export. The mapping step proposes a column for each field from its name, as for a file of any app: check each proposal, and choose the column yourself where Hourbun proposes none.
Bring more than the time#
The mapping step is for the file of time entries. The files of clients, projects, expenses and past invoices have no mapping step: they need the columns of Hourbun's format guide. Under the upload field, Download the format guide gives it. The guide ends with a prompt: give it and your Bonsai exports to an AI agent, and the agent converts them into these files. Upload them with the file of time, or all of them in one .zip file.
Give the agent the Companies, Projects, Expenses and Invoices downloads of Bonsai with the guide.
What does not come over#
- A column that no field of the mapping step takes, such as tags: it stays in the file.
- Receipt files of expenses, estimates and draft invoices: a CSV file has no place for them.
- Cost rates: an imported entry has no cost rate.
- Later changes in Bonsai: an import copies the file as it was exported, and is no sync.
Questions
Questions and answers
Can I move from Bonsai to Hourbun?
Yes. Download the Time Tracked CSV in Bonsai's Company Settings, Data, and upload it in Hourbun in Settings, Import, Another app (CSV). Hourbun proposes a column for each field, matches each person and shows a preview before the import.
Do my Bonsai clients and invoices come to Hourbun?
The clients and projects that the Bonsai time file names come over by name. Their details, the expenses and past invoices need the files of Hourbun's format guide: an AI agent can convert Bonsai's other CSV downloads into them.
Does Hourbun keep my Bonsai time in sync?
No. A CSV import copies the Bonsai export as it is. The next import of a newer export proposes the day after the latest entry of the last import as its Import from date, and an entry with the teammate, the project, the task, the date, the hours and the note of an entry of the workspace is not added again.
Sources
The export steps of Bonsai follow its own help pages, read on 16 November 2026: