Import Data

Bring your time tracking data from other tools into TeeckIn.

Overview

Switching from another time tracker? TeeckIn can import your existing data so you don't lose your tracking history. We support direct imports from popular tools, a generic CSV format, and full restoration from TeeckIn exports.

Supported Formats

Toggl Track

Direct import from Toggl exports. Categories map to projects, entries preserve all metadata.

CSV export from Toggl

Clockify

Import Clockify detailed reports. Projects become topics, tags are preserved.

CSV export from Clockify

Harvest

Import Harvest time entries. Clients, projects, and tasks are mapped automatically.

CSV export from Harvest

Generic CSV

Import from any tool using our standard CSV format. Map columns during import.

Custom CSV file

TeeckIn Export (v3)

Restore from a previous TeeckIn export. Perfect for backups or migrating between accounts.

TeeckIn JSON export

Importing from Toggl

  1. 1
    In Toggl: Go to Reports then Detailed
  2. 2
    Select the date range you want to export
  3. 3
    Click Export and choose CSV
  4. 4
    In TeeckIn: Go to Account Settings then Data
  5. 5
    Click Import Data
  6. 6
    Select Toggl Track as the source
  7. 7
    Upload the CSV file
  8. 8
    Review the preview and mapping
  9. 9
    Click Import

Note

Toggl projects become TeeckIn topics. If you have Toggl clients, they become categories containing those projects.

Importing from Clockify

  1. 1
    In Clockify: Go to Reports then Detailed
  2. 2
    Set your date range and any filters
  3. 3
    Click Export and choose CSV
  4. 4
    In TeeckIn: Go to Account Settings then Data
  5. 5
    Click Import Data
  6. 6
    Select Clockify as the source
  7. 7
    Upload the CSV file
  8. 8
    Review the mapping and adjust if needed
  9. 9
    Click Import

Generic CSV Import

For tools without direct support, use a CSV with these columns:

ColumnRequiredFormat
dateYesYYYY-MM-DD
start_timeYes*HH:MM or HH:MM:SS
end_timeYes*HH:MM or HH:MM:SS
durationYes*HH:MM:SS or minutes
projectNoText (becomes topic)
categoryNoText
descriptionNoText (becomes notes)
tagsNoComma-separated
hourly_rateNoNumber
billableNotrue/false or yes/no

* Provide either start_time + end_time OR duration

Tip

During import, you can map columns from your CSV to TeeckIn fields if the names don't match exactly.

Restoring from TeeckIn Export

You can restore your data from a TeeckIn v3 export. This is useful for:

  • Restoring from a backup after data loss
  • Migrating data to a new TeeckIn account
  • Moving between self-hosted and cloud versions
  1. 1
    Go to Account Settings then Data
  2. 2
    Click Import Data
  3. 3
    Select TeeckIn Export as the source
  4. 4
    Upload your JSON export file
  5. 5
    Confirm by entering your password
  6. 6
    Wait while the import completes

Warning

Importing will replace ALL your existing data. Make sure to export your current data first if you want to keep anything.

What Gets Restored

  • Your account settings and preferences
  • All personal workspace data (categories, topics, time entries)
  • Clients, invoices, and transactions
  • Tags and accounting labels
  • Recurring entries and time goals
  • Gamification progress (streaks, XP, achievements)
  • Organizations you own (with all their data)

What Must Be Reconfigured

Warning

For security reasons, some data cannot be restored from exports:
  • SMTP email settingsYour email configuration must be re-entered after import
  • Agent credentialsOAuth secrets must be regenerated; only agent metadata (names, types) is preserved
  • Attachment filesOnly metadata is restored; the actual files cannot be recovered
  • Two-factor authenticationMust be set up fresh for security

Note

Imports only work with v3.0.0 format exports. Older export formats are not supported and will need to be migrated first.

Column Mapping

When importing, the wizard shows a mapping screen:

Your column: "Project Name"maps toTopic
Your column: "Start"maps toStart Time
Your column: "Stop"maps toEnd Time

You can change mappings, skip columns, or set default values for missing data.

Import Preview

Before importing, you'll see a preview showing:

  • Number of entries to import
  • Date range of the data
  • Categories and topics that will be created
  • Any warnings about duplicate or invalid entries

Warning

Review the preview carefully. Imports cannot be undone - you would need to manually delete imported entries.

Handling Duplicates

TeeckIn checks for potential duplicates during import:

Skip Duplicates

Entries with the same date, start time, and topic are skipped.

Import Anyway

Import all entries even if they might be duplicates.

Review Each

Show potential duplicates and let you decide for each one.

After Import

Once the import completes:

  1. 1
    Check the import summary for any skipped entries
  2. 2
    Go to the Calendar to verify entries appear correctly
  3. 3
    Review the new categories and topics in Settings
  4. 4
    Set hourly rates on topics if not imported
  5. 5
    Delete any unwanted imported entries if needed

Note

Imported entries are marked internally so you can filter or identify them later if needed.

Troubleshooting

Import fails with 'Invalid date format'

Ensure dates use YYYY-MM-DD format. Convert in Excel/Sheets before importing.

Times are off by several hours

Check timezone settings. TeeckIn uses your account timezone for imports.

Some entries are missing

Check the import summary for skipped entries. Common reasons: duplicate detection, missing required fields.

Categories/topics not created correctly

Review the column mapping. Make sure project/category columns are mapped correctly.

TeeckIn import fails with 'Invalid format'

Make sure you're using a v3.0.0 export. Older exports use a different format and cannot be imported directly.

SMTP/email not working after restore

SMTP credentials are not included in exports for security. Re-enter your email settings in Account Settings.