From c23f0e6c7377422b6197fff54ec437252b58ec7c Mon Sep 17 00:00:00 2001 From: FuzzyGrim Date: Sun, 24 May 2026 14:08:32 +0200 Subject: [PATCH] document yamtrack csv tv row ordering #1419 --- docs/media-imports.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/media-imports.md b/docs/media-imports.md index fe427c26..99e516f0 100644 --- a/docs/media-imports.md +++ b/docs/media-imports.md @@ -86,11 +86,13 @@ Steam import requires a Steam API key and your Steam ID 64. Use this format to bulk-import media into YamTrack. Every row represents a single media instance. +The order of rows matters for TV data: import `tv` rows first, then `season` rows, then `episode` rows. Episodes depend on their parent season, and seasons depend on their parent TV show. + | 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`. | +| media_type | **Yes** | movie | One of: `tv`, `season`, `episode`, `movie`, `anime`, `manga`, `game`, `book`, `comic`. For TV data, rows must be ordered as `tv`, then `season`, then `episode`. | | title | No | Inception | Leave blank to let YamTrack fetch the title from the provider automatically with the `media_id`. | | image | No | | 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`. |