Contents
On this page

Import and export - Plugixa Stream

The whole catalogue fits in one CSV file: every series, every movie with its video, and every episode. Export it to back it up, to move it to another site, or to edit hundreds of titles in a spreadsheet, then import the file back. The import is checked before anything is written.

Open Plugixa Stream > Series & movies and click Import / export.

The Import and export dialog with the Export section and its Download CSV button, and the Import section with its explanation and the Choose a CSV file button

Export

Click Download CSV. The file is named after your site and the date, such as my-site-catalog-2026-11-17.csv, and holds every title and episode that is not in the trash, whatever its status.

The file is saved as UTF-8 and opens with accents intact in Excel, LibreOffice and Google Sheets. A cell that starts with =, +, - or @ is written with an apostrophe in front, so a spreadsheet shows it as text instead of running it as a formula. The import removes that apostrophe again.

The file format

One row per thing, and the first line names the columns. The easiest way to start a file is to export your catalogue and keep its first line.

type What the row is
series A series
movie A movie and its one video, on the same row
episode An episode of the series named in its series column

Columns that do not apply to a row stay empty.

Column Used on What it holds
type All series, movie or episode. Required.
id All The id of an existing title or episode to update. Empty adds a new one.
series Episodes The id or the exact title of its series, on the site or higher up in the file
season Episodes, movies The season number
number Episodes The episode number
title All The title. Required for a new series or movie.
status All publish or draft
description All The synopsis of a title, or the description of an episode
year Titles The release year
age_rating Titles Empty, all, 7+, 13+, 16+ or 18+
release_status Series ongoing or completed
original_lang Titles The spoken language, as a code such as en
genres, tags, studios, languages Titles Names separated by |, such as Drama|Mystery
featured Titles 1 to feature on the home page, 0 not to
free_count Titles The number of free episodes. Empty uses the site default.
trailer_url Titles The trailer link
poster_url, banner_url Titles Image links
provider Episodes, movies self_hosted for a Media Library file or a file URL, embed for YouTube, Vimeo or another embed
video Episodes, movies A Media Library attachment id, a file URL, or an embed link
duration Episodes, movies Length in seconds
access Episodes, movies auto (follow the series rule), free or paid
intro_start, intro_end, credits_start Episodes, movies Skip markers, in seconds
thumbnail_url Episodes, movies The episode’s thumbnail link

The values mean the same as the fields of the forms. See Series and movies, Episodes and Video sources.

A short file that adds a series with two episodes and a movie:

type,series,number,title,status,year,genres,provider,video,duration
series,,,Harbour Lights,publish,2024,Drama|Mystery,,,
episode,Harbour Lights,1,The Storm,publish,,,self_hosted,https://cdn.example.org/1.mp4,1500
episode,Harbour Lights,2,The Wreck,,,,self_hosted,https://cdn.example.org/2.mp4,1450
movie,,,Night Train,,1999,Thriller,self_hosted,https://cdn.example.org/m.mp4,5400

The second episode and the movie have no status, so they are created as drafts.

How rows are matched

The row What happens
Has an id That title or episode is updated. An id that does not exist is an error.
An episode with no id, whose number its series already has That episode is updated
Anything else A new title or episode is created, as a draft unless its status says publish

Exporting, editing and importing the same file therefore updates your catalogue in place, and importing it on another site creates everything there.

Inside a row:

  • A missing column leaves the field as it is. Leave out every column you do not want to touch.
  • An empty cell clears the field, for example an empty poster_url removes the poster and an empty genres removes every genre. Empty title, status, number and video cells (season to credits_start) are the exception: they keep what is there.
  • Names in genres, tags, studios and languages that do not exist yet are created.
  • An image link already in your Media Library is reused. Any other link is downloaded into the Media Library once, and never downloaded again on a later import. Images can be up to 15 MB.
  • A movie’s status applies to the movie and to its video.
  • An episode row cannot point to a movie: put a movie’s video on the movie’s own row.

Every value goes through the same checks as the forms, so a file cannot store anything the admin app would refuse.

Import

  1. Click Choose a CSV file and pick the file.
  2. The file is checked at once, without changing anything. The dialog says Ready. Nothing has been changed yet., how many titles and episodes will be created and updated, and lists any row with a problem by its line number.
  3. Click Import. The rows are imported in batches of 25, with a progress bar, so a long file never times out.
  4. When Import finished. shows, click Close.

The Import and export dialog after choosing a file, saying Ready. Nothing has been changed yet. with the number of new and updated titles and episodes, and the Import button

Rows with a problem are skipped and the rest are imported. The check catches most problems; a few, such as an image link that cannot be downloaded or an episode number already taken, only show up during the import, and the dialog lists those rows when it is done. Fix them and import a file with only those rows. Titles are matched by id only, so importing the whole file again without ids would add every new series and movie a second time. Export first to get their ids.

Import stays disabled when every row of the file has a problem.

Limits and permissions

Limit Value
File size 5 MB. Split a bigger catalogue into several files.
Rows 5,000 per file, blank lines not counted
Required columns type and title in the first line

Columns the plugin does not know are ignored, so you can keep notes in an extra column.

Anyone who can open the list can export. Importing needs the right to create and to edit titles: the Import section is hidden for other users. See Series and movies.

What is not in the file

The file holds the catalogue only. Viewers’ progress, My List, settings, home rows and, with Pro, prices, subtitles, cast and custom fields are not part of it.

A scheduled episode is exported with the status future and its release date and time (site time) in the publish_at column, so importing the file keeps it scheduled. A row with the status future and an empty publish_at is imported as a draft.

Quick Links

Share