Skip to content

Import your time from any app with CSV

By Fred Wu, maker of Hourbun · Checked · Report a mistake

The short answer

Hourbun imports the CSV export of any app. In Settings, Import, choose Another app (CSV) and upload the file of time entries, with files of clients, projects, expenses and past invoices beside it if you have them. Hourbun proposes a column for each field, matches each person to a teammate, checks the whole import and shows a preview before it imports anything.

Before you start

Export your time entries as CSV from the app that you use now. Hourbun maps the columns of that file for you, and knows the column names of the exports of Toggl and Clockify.

To bring more than the time, add a file of each kind beside it: clients, projects, expenses, invoices, invoice lines and payments, in the format of Hourbun. Under the upload field, Download the sample files (.zip) gives a file of each kind, and Download the format guide describes each column. The guide ends with a prompt: give it and your export to an AI agent, and it converts the export into these files.

Steps

  1. Open the import. In Hourbun, open Settings, then the tab Import, and choose Another app (CSV) under "Import from".
  2. Upload the files. Drop the .csv files, or one .zip file with all of them, on the field, or use Choose files. Then press Read the file.
  3. Check what each file holds. With more than one file, Hourbun proposes the kind of each one: change a kind if it is wrong, then press Continue.
  4. Check the columns. Hourbun proposes a column for each field of the time file: the date, the project and the hours (or the start and the end time) are required, and the client, task, person, note, billable, rate and invoice number are optional. Check the formats of the dates and the hours, and the defaults for rows with no client or no task. The preview shows the first 5 rows as Hourbun reads them, and marks a value that it cannot read.
  5. Choose what comes. An Import from date leaves out the rows before it. Keep Import past invoices on to bring the invoices of the invoices file; with it off, each billed row comes over as billed elsewhere.
  6. 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.
  7. Check the file. Press Check the file. Hourbun runs the whole import and rolls it back, then shows the preview: the verdict, what comes over, the money check and what needs you.
  8. Import. Press Import and confirm.

Import again later

The next CSV import proposes the day after the latest entry of the last one as its Import from date, and a record that the workspace has already is used, never added twice. A CSV import is not a sync: each import is a new upload.

Limits of one import

  • At most 7 files: one of time entries and one of each other kind.
  • At most 30 MB, in one file or in all files together.
  • At most 100,000 rows of time, and 2,000 clients, projects, tasks or people. Import a larger export in parts by date.

Questions

Questions and answers

Which apps can I import into Hourbun with CSV?

Any app that exports its time entries as CSV. Hourbun maps the columns of the file in a step of the import, proposes the column names of the exports of Toggl and Clockify by itself, and reads dates and hours in the common formats.

Can an AI agent prepare my CSV files for Hourbun?

Yes. Hourbun's format guide describes every file and column, and ends with a prompt to copy: give the guide and your export to an AI agent, and it converts the export into the files of the import.

Can I import past invoices into Hourbun from a CSV file?

Yes. Add an invoices file, with files of invoice lines and payments if you have them, beside the file of time. Hourbun builds each invoice from the rows of time, expenses and lines that name it, and checks its total against the total of the file, to the cent, before the import.

Try Hourbun for free.

14 days, no card. Add a client, track your first hour, and send the invoice.