Upload and manage assets in the Media Library

Uploading files

Supported file types

The following file types can be uploaded to the Media Library:

Upload images, Lottie files, and documents

You can upload images, Lottie files, and documents to the Media Library in two ways:

• Click + Add new media in the top-right corner.
  Drag and drop files into the upload window, or click Upload media to choose files from your computer.

• Drag and drop files directly into the Media Library or into a specific folder.

Files are always uploaded to the folder that is currently open.

Upload videos

In addition to images and documents, you can add videos to the Media Library.

1. Click + Add new media in the top-right corner of the Media Library.
2. Select Add video.
3. Select your video source from the dropdown and complete the remaining fields outlined below

YouTube - Name your video and paste the watch URL.

⚠️ Use the standard watch URL format only:

• ✅ Supported: https://www.youtube.com/watch?v=[VIDEO_ID]
• ❌ Not supported: https://youtu.be/[VIDEO_ID] (Share URL)
• ❌ Not supported: https://youtube.com/watch?v=[VIDEO_ID]&list=[LIST_ID] (Playlist URL)

Vimeo - Name your video and paste the URL from Vimeo.

Wistia - Name your video and paste the URL from Wistia. Be sure to use one of the supported URL formats:

• https://wistia.com/medias/[VIDEO_ID]
• https://[CUSTOM_SUBDOMAIN].wistia.com/medias/[VIDEO_ID]
• https://wistia.com/embed/medias/[VIDEO_ID]
• https://[CUSTOM_SUBDOMAIN].wistia.com/embed/medias/[VIDEO_ID]

Brightcove - Name your video and paste the URL from Brightcove. Be sure to use the supported URL format: https://players.brightcove.net/[ACCOUNT_ID]/default_default/index.html?videoId=[VIDEO_ID]. To find this URL in Brightcove, click Publish and embed and copy the preview link.

Self-hosted video - Name your video and paste a direct .mp4 URL. The URL must end in .mp4 — it cannot be an embed code or a standard .com link.

Foleon-hosted video - Upload a video file directly to your Media Library without relying on external platforms. Adjust the fallback image if needed. This image displays if the video cannot play.

Managing assets

Locate a file from the Editor

When working with large libraries, it can be hard to track down where a specific file is stored. From the Editor, you can quickly navigate to the exact folder a file is in.

1. Open your Doc in the Editor and navigate to the image or video you want to locate.
2. In the element settings, click Replace.
3. If the file is used as a background on a block, column, or card, click Change background, then hover over the image or video and click Replace.
4. The Media Library opens in the folder where the file is stored, with the file already selected.

See where an asset is used

Before editing, replacing, or removing an asset, you can check which documents are using it. This helps you understand the impact of any changes before you make them.

1. Find the file in the Media Library.
2. Click the quick actions menu (⋮) on the file.
3. Select Used in.
4. Review the overview of where the file is used:
   • 🟢 Live assets — the file is used in a published Doc or asset (green dot)
   • ⚪️ Draft assets — the file is used in an unpublished Doc or asset (grey dot)
5. Click the link to open the asset in the editor.

Replace an asset

Replace an image once, and every document using it updates automatically, without breaking existing links. This is useful when a file needs to be refreshed across multiple Docs.

1. Find the file you want to replace in the Media Library.
2. Click the quick actions menu (⋮) on the file.
3. Select Replace.
4. Review the list of documents where this file is currently used.
5. Click Continue to proceed.
6. Upload the new file.

Download files

To download a file you've previously uploaded to the Media Library:

1. Double-click a file, or select Preview from the quick actions menu (⋮).
2. Click the download arrow in the preview window.