Skip to main content

Attach related files to a media item

The Videas teamFeb 25, 20266 min read

To attach a PDF, a slide deck or a transcription to a video in Videas, use attached files: open the media item’s detail page in Mediasbox (your media library), go to the Files tab, section Attached files, and click Add a relation. You can upload a new file or pick one from your library, then set the relation type and its visibility. You need the Editor role (or above).

Three things not to confuse, all on the Files tab: Versions (the same media item evolving over time — see Manage the versions of a media item), Attached files (other media items attached to it — this guide), and Subtitles (their own tab — see Generate subtitles automatically).

Add a relation

On the Files tab, the Attached files section shows No attached file when nothing has been attached yet. Click Add a relation: a wizard opens.

the “Attached files” section with the “Add a relation” button

1. The file source

  • Upload a file — you send a new file from your computer (drag and drop works, several at a time). Videas warns you: “Files will be linked directly to this asset and will not be visible in your library” — this is “attached only” mode (see below).
  • Select from library — you pick a media item already in Mediasbox (multi-select). Valuable for attaching the same PDF to several videos without uploading it again.

2. The relation type

The Relation type field describes the link. It defaults to Linked, but you can be more specific: Derived from, Version of, Part of, Duplicate of, Alternative to, Reference, or Subtitle for. This type helps describe the nature of the relationship between the two media items (for example a clip that is Part of the full conference).

An attached file can be of any type: video, audio, document (PDF, Office…), image or archive.

Set up each attached file

For each row:

  • Visibility — a Public / Private toggle. In Public, “this file will be displayed on the sharing pages” of the parent media item; in Private, it stays reserved for workspace members (useful for a brief or an internal script).
  • Order — drag and drop the rows; the order is respected on the viewer’s side.
  • Description — a short piece of text (“Course handout — March 2026”) shown next to the file on the sharing pages.

“Attached file” or “Library”?

A badge on each row is a reminder of where the file comes from:

  • Attached file — the file exists only as an attachment, it does not appear in Mediasbox. Ideal for a resource with no standalone value (the brief for this specific video). This is what you get with a file uploaded from the wizard.
  • Library — the file also lives in Mediasbox as a media item in its own right: searchable, taggable, attachable to several parents. Ideal for a reusable resource (an onboarding booklet attached to ten videos). This is what you get with a file selected from the library.

On the viewer’s side

On a sharing page for the parent media item, attached files set to Public appear below the player, with their description and a download button — no account required. Private files stay invisible to the public.

Typical use cases:

Parent media item Relevant attached file
Training video Summary PDF, exercise sheet
Podcast PDF transcription, press kit
Webinar Slides as a PDF, resources mentioned
Product video Spec sheet, installation manual

Detach or delete

From the action menu on a row:

  • Detach removes only the link. A Library file stays in Mediasbox; an attached-only file goes to the trash (restorable during the retention period).
  • Delete sends the file to the trash.

If you send the parent media item to the trash, its attached-only files go with it; Library files stay intact, only the link disappears.

Attached file, version or subtitle: which one?

All three live on or beside the Files tab, and they are easy to confuse. A version is the same media evolving — a re-edit that replaces the previous file without breaking links. An attached file is another media item tied to it — a handout PDF, a transcript, a press kit. A subtitle has its own tab and its own lifecycle.

The question that settles it: does this file replace the media, or does it accompany it? If it replaces it, it is a version. If it accompanies it, it is an attached file.

Should I upload the file or take it from the library?

Upload when the resource only makes sense next to this particular item — the brief for this video, a production note. The file then exists only as an attachment: it does not appear in Mediasbox and does not clutter your library.

Select from the library when the resource is reusable — an onboarding booklet attached to ten videos, a brand guide, a product catalogue. The file stays a media item in its own right: searchable, taggable, attachable to several parents, and editable in one place.

Is an attached file visible to the viewer?

Only if you set it to Public. The Visibility toggle on each row decides: in Public, the file appears under the player on the parent media’s share pages, with its description and a download button — no account required. In Private, it stays reserved for workspace members.

That is what lets you keep an internal brief and a course handout in the same place, exposing only the second.

What happens if I delete the parent media?

Its attachment-only files go to the trash with it, since they exist only through that attachment. Files that came from the library stay intact in Mediasbox: only the link disappears.

The same logic applies to the Detach action on a row: it removes the link, not the file. A library file stays in Mediasbox; an attachment-only file goes to the trash, restorable for the retention period.

What is the relation type for?

To qualify the nature of the link for whoever reads the page. Related by default, it can be made specific: Derived from, Version of, Part of, Duplicate of, Alternative to, Reference, or Subtitle for.

It is descriptive information, not behaviour: an excerpt marked Part of the full conference remains an ordinary attached file. The value is documentary — it stops anyone wondering, six months later, why these two items are tied together.

In summary

  • Attached files attach other media items (PDF, slides, transcription…) to a parent media item
  • Files tab → Attached files section → Add a relation
  • The wizard: Upload a file or Select from library, plus a Relation type (Linked, Derived from, Version of…)
  • Per file: Public / Private, order, description
  • Badge Attached file (attachment only) or Library (reusable media item)
  • In Public, the file can be downloaded from the sharing pages; the Editor role (or above) is required

Screenshots were taken on Videas Academy, an example channel built for this help center. It belongs to a fictional customer, not to Videas: your own channel carries your name, your branding and your prices.