Importing TrainingPeaks workout notes (CSV)

What this import does

The Hub has a built-in CSV importer for TrainingPeaks workout notes. Drop a TP workout export CSV onto the activity upload page and the importer:

• Matches each row to an existing Activity by date plus sport.
• Appends the workout notes, RPE, and feeling to Activity.notes with a --- TrainingPeaks --- separator so the original FIT description is preserved.

The importer is in core/services/csv_importer.py.

Expected CSV format

The importer auto-detects this file format by looking for both WorkoutType and WorkoutDay in the headers. If your TP export contains those columns, it will be recognised.

Recognised WorkoutType values mapped to Hub sports:

• Swim to swim.
• Bike to bike.
• Run to run.
• Strength to strength.
• Other to other.

(Lowercase variants are also accepted.)

How to export from TrainingPeaks

In TP, go to your athlete export and select the Workouts report. Choose a date range that overlaps with activities already in the Hub (the importer needs the Activity rows to exist already; it does NOT create new ones).

Save the file as .csv.

How to import in the Hub

1. From the coach dashboard, click Upload activities.
2. Use the CSV import section.
3. Pick the athlete.
4. Drop the CSV.
5. The importer returns a summary: how many rows matched existing Activities and how many did not.

What "matched" means

For each CSV row, the importer looks for an Activity row with the same date and the same sport. If found, the notes are appended.

If no match exists, the row is reported as unmatched. To fix unmatched rows:

• Upload the corresponding FIT file first.
• Re-run the CSV import.

What does not get imported

The workout-notes importer does not:

• Create new Activity rows from the CSV. The Activity must already exist from a prior FIT upload.
• Update structured metrics like AdjP, IF, Load (those come from the FIT parser).
• Touch wellness, equipment, or race data.

Caveats

• If you have multiple activities on the same day in the same sport, the importer matches the first one it finds. In practice this is rare; most athletes do at most one bike, one swim, one run per day.
• The append is one-way. Re-running the same CSV will append the notes a second time. Run once per dataset.

See also: Importing TP biometrics CSV, Importing TP activities (FIT zip), Activity notes thread.