Upload via CSV
CSV import is the fastest way to work with a large library. Use it to add many videos at once, or to update names, descriptions, categories, privacy, pricing, and more across your whole library in one go. CSV import is available on all paid plans.
In this article:
- What you need: the links you need before you start
- Add videos with a CSV file: import new videos in bulk
- Update existing videos: export your library, edit it, and import it back
- What an empty cell does: which fields an empty cell clears and which stay the same
- How Bamboo reads each row: when a row adds a video, updates one, or is skipped
- CSV columns: what to put in each column
- Troubleshooting: what the import messages mean and how to fix them
What you need
Each new video needs one of these:
- A direct download link, to upload the video to Bamboo. When you paste the link into your browser's address bar, it should download the video file or play the file directly. If it opens a web page, it's not a direct link.
- An HLS URL, to add an external video that stays hosted where it is.
Add videos with a CSV file
- Go to Content → Videos, click Add Video, and choose Import from CSV.
- Click Download Sample CSV to get a template with all the columns. One sample row includes a price, so you can see where it goes.
- Read the note rows at the top of the sample (every row that starts with #), then delete them. Keep the header row and your video rows.
- Fill in one row per video. See CSV columns below.
- Click Click to select a .csv file and choose your file.
- Click Import. When you see Import started successfully, click Done.
Your new videos appear at the top of your library within a few minutes, with the status Converting while Bamboo processes them.
Privacy for new videos: new videos always get your account's default privacy, set in Content → Content Settings → Default Content Privacy. If the default is Private, every imported video is added as Private, whatever your file says. To make them public, update them with the info.isPrivate column, or change them in Content → Videos.


Update existing videos
- Go to Content → Videos and click Export CSV. You'll get a CSV file with all your videos and their details.
- Open the file in Excel, Google Sheets, or any spreadsheet app.
- Delete the columns you aren't changing. Keep the id column and the columns you want to update.
- Make your changes and save the file as CSV.
- Import it with Add Video → Import from CSV.
What an empty cell does
When a row matches a video you already have, every column in your file is applied to it, even if the cell is empty. Here's what an empty cell does:
- Name, Description, Tags: the field is cleared.
- Privacy: the video is set to Public.
- Price: the one-time price is removed.
- Subscriptions: the video's subscriptions are removed.
- Categories: nothing changes. Categories are only ever added, never removed. To take a video out of a category, use Actions → Remove from Categories in Content → Videos, or edit the video.
- Thumbnail: nothing changes. The current thumbnail stays.
- Start date: nothing changes.
- Reference ID: nothing changes.
- Duration: nothing changes. The import never updates the duration of an existing video.
- Video file link (url): nothing changes. The import only adds a file to a video that doesn't have one, and never replaces one.
To change only some fields, delete the columns you don't want to change. Columns that aren't in your file are never touched.
How Bamboo reads each row
For every row in your file, Bamboo decides whether to update a video or add a new one:
- The row has an id: Bamboo updates the video with that ID.
- No id, but the referenceId matches an existing video: Bamboo updates that video.
- Anything else: Bamboo adds it as a new video.
If a row matches an existing video but only its name is filled in, Bamboo skips it and the video stays as it is.
Tip: give every video a referenceId, such as the ID it has in your own system. You can then update your videos by importing the same file again, without needing Bamboo's IDs, and no video is ever added twice.
CSV columns
The first row of your file must be the header row with the column names, and it must include an id or referenceId column. For new videos, leave the id cells empty.
Columns marked with * are required for new videos. Optional columns can be left empty or left out. When you update videos, see What an empty cell does first.
For every video
- id: Bamboo's ID for the video. Leave it empty for new videos. To update a video, keep the ID from your export.
- name*: the video's name.
- description: the video's description.
- tags: separate multiple tags with commas.
- categories: separate multiple categories with commas. For a sub-category, use >, for example Movies>Action. Categories that don't exist yet are created for you. On existing videos, these are added to the current categories.
- thumbnailUrl: a direct link to the thumbnail image itself.
- startDate: when the video becomes available, as a date and time, for example 2026-11-01 18:00.
- referenceId: your own unique ID for the video. See How Bamboo reads each row.
Privacy, price, and subscriptions
These columns set the same fields as the Privacy, Price, and Subscriptions options on the video's edit page.
- info.isPrivate (Privacy): for videos you're updating, 0 for Public and 1 for Private. New videos always get your account's default privacy instead (see Add videos with a CSV file). Private videos are hidden from everyone, including viewers who subscribed to them or bought them.
- info.price (Price): a one-time price, in numbers only, for example 4.99. Leave it empty for no one-time price. If the video has subscriptions, it stays available only to subscribers.
- info.package (Subscriptions): the ID of the subscription that unlocks the video, not its name. For more than one subscription, separate the IDs with commas and put the whole cell in quotes, for example "id1,id2". Leave it empty for no subscription.
To find a subscription's ID: go to Monetization, open Subscriptions, and click the subscription. The ID is at the top of its page.
Double-check your subscription IDs. Bamboo saves the ID exactly as you type it. If it doesn't match a real subscription, the video is locked behind a subscription no one can buy. That's also why the sample file leaves info.package empty.

For videos uploaded to Bamboo
- url*: the direct download link of the video file. Bamboo downloads the file and processes it. On an existing video, it's used only if the video has no file yet.
For external videos
- info.hlsUrl*: the video's HLS URL. A column named hlsUrl works too.
- duration: the video's length in seconds. Used when the video is added.
Tip: the import reads only the columns listed above. Your export includes more columns, such as order, endDate, downloadUrl, and createdAt. Those stay as they are when you import, so edit them on the video's page instead.

Troubleshooting
If the import can't read your file, it stops and shows one of these messages:
- "The file still has the sample's note rows (starting with #)." Delete every row that starts with #. Keep the header row and your video rows, then import again.
- "The first row must be the header, with an "id" or "referenceId" column." Make sure the first row of your file holds the column names and includes an id or referenceId column. Download the sample CSV to see the right format.
- "The file has a header row but no videos." Add at least one video row under the header row.
- "The file is empty." Check that you selected the right file and that it was saved with your data.
Learn more: Add Videos to Your Library · Create & Edit Categories
Need help? Contact us.