[Guides](https://hourbun.com/guides)

# [Move from FreshBooks to Hourbun](https://hourbun.com/guides/move-from-freshbooks)

By Fred Wu, maker of Hourbun · Checked 16 November 2026 · [Report a mistake](mailto:support@hourbun.com)

## The short answer

Export your FreshBooks time as CSV: in Reports, open Time Entry Details under Time Tracking Reports, then More Actions, Export for Excel, which downloads a CSV file. 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.

## What you need

- A Hourbun workspace in which you are the owner or an admin
- A FreshBooks account that can open Reports

## Export your time from FreshBooks

1. In FreshBooks, open **Reports**, then **Time Entry Details** under Time Tracking Reports.
2. To add columns, open **Customize Report** under Settings: Billable Rate, Total Billable, Cost Rate and Total Cost.
3. Open **More Actions** at the top right and choose **Export for Excel**. A CSV file downloads.

The report on the screen rounds each entry to the nearest minute. The CSV file has the exact time, to 4 decimal places, and Hourbun rounds it half-up to two places.

## Import the file into Hourbun

1. **Open the import.** In Hourbun, open **Settings**, then the tab **Import**, and choose **Another app (CSV)** under "Import from".
2. **Upload the file.** Drop the `.csv` file on the field, or use **Choose files**, then press **Read the file**. The field takes `.csv` files, or one `.zip` file 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.
3. **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:MM` or `H: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.
4. **Choose what comes.** An **Import from** date leaves out the rows before it.
5. **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.
6. **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.
7. **Import.** Press **Import** and confirm.

## The columns to check

FreshBooks'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.

A Cost Rate column has no field: an imported entry has no cost rate.

## 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 FreshBooks 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.

FreshBooks also exports its clients, expenses and invoices as CSV files: give them to the agent 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 FreshBooks: an import copies the file as it was exported, and is no sync.

## Questions and answers

### Can I move from FreshBooks to Hourbun?

Yes. Export the Time Entry Details report of FreshBooks with More Actions, Export for Excel, which downloads a CSV file, and upload it in Hourbun in Settings, Import, Another app (CSV). Hourbun shows a preview before the import.

### Do my FreshBooks invoices come to Hourbun?

They can, as past invoices. FreshBooks exports its clients, expenses and invoices as CSV, and an AI agent with Hourbun's format guide converts them into its files. Hourbun checks the total of each invoice to the cent before the import.

### Does Hourbun keep my FreshBooks time in sync?

No. A CSV import copies the FreshBooks 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 FreshBooks follow its own help pages, read on 16 November 2026:

- [FreshBooks: What is a Time Entry Details report?](https://support.freshbooks.com/hc/en-us/articles/115002979847-What-is-a-Time-Entry-Details-report)
- [FreshBooks: How do I export my reports?](https://support.freshbooks.com/hc/en-us/articles/227478548-How-do-I-export-my-reports)
- [FreshBooks: How do I export my data?](https://support.freshbooks.com/hc/en-us/articles/360032628152-How-do-I-export-my-data)

## Related

- [Hourbun vs FreshBooks](https://hourbun.com/compare/freshbooks)
- [FreshBooks alternatives](https://hourbun.com/alternatives/freshbooks)
- [Import from any app with CSV](https://hourbun.com/guides/import-time-from-csv)
- [Imports in the help centre](https://hourbun.com/help/imports)
- [Copy your invoices to Xero](https://hourbun.com/guides/copy-invoices-to-xero)
- [Track time from ChatGPT, Claude and other AI assistants](https://hourbun.com/guides/track-time-with-chatgpt-and-claude)
- [All guides](https://hourbun.com/guides)
