What comes over to UseTimer

The import reads your Toggl Track data and turns it into ordinary UseTimer data:

• Closed time entries: description, start time, end time and the exact duration in seconds.
• Clients, projects and tasks: each entry keeps its assignment. Items that do not exist yet are created in the current workspace.
• Tags: up to 50 tags per entry; a tag repeated on the same entry is kept once.
• Billable: each entry's billable flag is carried over as it is.

Importing is available on every plan, including Free.

Before you start

• Create a UseTimer account and choose the workspace the data should go into.
• There are two ways in: a detailed CSV file exported from Toggl Track, or a direct read with your personal Toggl Track API token.
• The file must be a detailed time-entry report with a description column and start and end dates and times. Summary reports cannot be imported.
• Reading never changes anything in Toggl Track. Entries are imported into your own account only, and only after you confirm they are yours.

Option A: import a detailed CSV file

1. Open the app and go to the Import view (under Migration).
2. In the CSV import card, choose your file in Detailed CSV file. It must be UTF-8, up to 5,000 rows and 900KB. Split a larger file into several files.
3. In Stable source identifier, keep the suggested value or pick your own, and reuse the same value every time you import the same data again.
4. Choose the File timezone and the delimiter (comma or semicolon).
5. Tick I confirm these entries belong to me and should be assigned to my current account. If you already have clients, projects, tasks or tags with the same names, you can also tick the option to link to existing items with exactly the same name instead of creating new ones. It is off by default.
6. Click Validate file and preview. No time entry is created at this point.

Columns the import recognizes: Description, Client, Project, Task, Tags, Billable, Start date and Start time, End date and End time, Duration, and an entry identifier (ID) when the file has one. A duration that does not match the start and end times is flagged as an error, never guessed.

Option B: read directly with an API token

1. In the Import view, go to the Legacy Toggl Track: personal import card.
2. Paste the token into Toggl API token and click Discover source workspaces. The token stays only in page memory.
3. Choose the Source workspace and a date range (From date, Through date), up to one year per read.
4. Click Read the selected range. You can stop at any time with Stop reading.
5. Tick the ownership confirmation and click Preview the import.
6. When you are done, you can click Clear local source connection and data.

This way reads only your own closed entries, each with its stable identifier. The app states that this adapter is ready to test with your token but that a full live-account migration has not been verified yet, so source errors and limitations are shown in full, never hidden. If this way does not suit you, use the detailed CSV file instead.

Preview and confirm

Under Import run you see a summary: Valid rows, Invalid rows and the total time. Every row can be reviewed, 50 per page, with a filter for valid or invalid rows only.

• If some rows are invalid, fix the file and preview again, or explicitly accept leaving them out. The run is then not marked complete.
• If the workspace already has items with the names in the file, you are warned before duplicates are created, with a Use existing items and preview again button.
• Click Confirm and start import. Writing happens in batches, with Pause, Resume and Cancel remaining import, and counters for created, updated, unchanged and conflicts.

Re-import without duplicates

Every imported entry stays linked to its source. When you import the same data again with the same source identifier:

• An entry that has not changed is marked Unchanged and is not created again.
• An entry that changed at the source is updated, as long as you have not edited it in UseTimer.
• An entry you edited in UseTimer is never overwritten: it is flagged as a conflict for you to review.
• For a file without an entry identifier column, duplicate detection is complete only when you import exactly the same file again. An entry with the same times and description as an existing one stops for review and is never merged automatically.

Check the result, or undo it

• Compare against actual server data shows what was actually written against what was planned.
• Download reconciliation opens the same comparison and lets you save it as a file.
• Preview reversal of this import shows what would be undone before you confirm reversing an import run.
• Previous runs can be picked from the run list at the top of the view.

What does not come over

• A timer that is currently running at the source: only closed entries are imported.
• Historical rates: they are not part of the CSV file and are not copied by the direct read. You set rates in UseTimer.
• Team permissions at the source: they are not copied.

More tools, such as a catalog-only transfer (clients, projects, tasks and tags without hours) and team time transfer, are in the same view under Toggl 2.0, Focus, catalog and team.

Plans

UseTimer has three plans: Free, Pro and Team. Importing is available on all of them. On Free you can submit up to 2 timesheets per calendar month, and PDF report export is included from Pro upwards. Full details are on the plans page.

Get started

Create an account, choose a workspace and import your first file. You can start with a short range, check the result, and import the rest with the same source identifier, without duplicates.

• Create account
• Open the app

Toggl and Toggl Track are trademarks of their respective owners; UseTimer is not affiliated with them.