Toggl allows you to bulk import data via CSV files on our Import page. CSV import is limited to workspace admins

This guide details tips on creating this CSV file. For more information on importing datasets and sample tables, please read this guide.

General requirements

To import data from a CSV file to Toggl, the CSV file must have:

  • Comma-separated values
  • UTF-8 encoding

Columns and column structure

Columns must have headers in English. The allowed column headers are:

  • User 
  • Email 
  • Client
  • Project (All new projects are private by default)
  • Task (only available on paid plans)
  • Description
  • Billable (only available on paid plans)
  • Start date
  • Start time
  • Duration
  • Tags

The order of columns isn't important. You can also import one, all, or specific set of columns. It depends on what you're importing. Some samples are available here.

Do note, if the import tool finds multiple time entries that have identical data, including start date and time, it will merge them.

Columns that you can import on their own:

  • Email (to import users)
  • Client
  • Project (All new projects are private by default)
  • Tags

 Columns that must have at least one other column:

  • User – must have Email to attach it to
  • Task – must have Project to attach it to
  • Description – must have Email, Start date, Start time, Duration
  • Billable – is a time entry flag only so must have at least Email, Start date, Start time and Duration attached

Quick tip: The easiest way to see how your CSV file should look like is to export a Detailed report into the CSV. 

Notes for Windows and Excel users

When using Excel on Windows, pay attention to these things:

  • Regional settings – make sure that your list separator is a comma.
  • Date and time fields – they must be in the required format as explained in Importing time entries here. If you don’t manually import the file and set the fields to “Text”, Excel will likely change your date/time fields to a different format.
  • UTF-8 export – some Excel versions struggle with exporting UTF-8. If Toggl rejects your CSV, open it in regular ol’ Notepad and save it as a new CSV file encoded in UTF-8. You should see the “Encoding” option inside the Save As window. 

Uploading the CSV file

Data can be imported to Toggl from a CSV file by uploading the file via the Import page.

Once there, click on the "Select CSV file to upload" icon and upload your CSV. You can also drag and drop a file in this area. 

The importer will analyze your file and show an error if it can't be imported. You will also see what you will be importing (how many projects, users, etc.). 

If everything looks good, click “Import now” to complete the process.

Keep in mind that:

  • The app always displays the “Adding new users increases your workspace fee” warning. If you’re uploading time for existing users, just ignore this.
  • When importing users via CSV, ticking the option to invite new users will make them active or invited users, whereas not ticking this option will make them inactive users. Inactive users can be seen on the Team page under the Inactive filter
  • Maximum file size is 1 MB.

Having trouble importing your data? Contact our support team via chat or email for assistance! :) 

Did this answer your question?