Yamtrack CSV Format

Use this format to bulk-import media into YamTrack. Every row represents a single media instance.

Column Title	Required?	Example Value	Notes
media_id	No	12345	ID of the item on the chosen provider. Must be unique per (source, media_type). Leave blank to let YamTrack fetch the title from the provider automatically with the title.
source	Yes	tmdb	One of: tmdb, mal, mangaupdates, igdb, openlibrary, hardcover, comicvine, manual.
media_type	Yes	movie	One of: tv, season, episode, movie, anime, manga, game, book, comic.
title	No	Inception	Leave blank to let YamTrack fetch the title from the provider automatically with the media_id.
image	No	https://image.tmdb.org/t/p/w500/qmDpIH...jpg	Public poster/cover URL. Leave blank to auto-fetch from the provider automatically with the media_id or title.
season_number	Cond.	2	Required when media_type = season; also required (together with episode_number) when media_type = episode.
episode_number	Cond.	5	Required when media_type = episode; ignored otherwise.
score	No	8.5	Decimal 0–10 (stored as a 100-point integer internally).
status	Yes	Completed	One of: Completed, In progress, Planning, Paused, Dropped. Capitalisation must match.
notes	No	Watched in cinema	Free-text.
start_date	No	2023-01-16 03:56:13+00:00	Full ISO-8601 timestamp with timezone YYYY-MM-DD HH:MM:SS±HH:MM.
end_date	No	2023-02-10 22:15:00+00:00	Same format as start_date.
progress	No	10	Numeric progress (e.g., chapters, pages, minutes). Ignored for tv and season because progress is tracked with episode rows.