Skip to content
  • There are no suggestions because the search field is empty.

Upload and manage assets

This article covers how to upload files, manage assets across your Docs, and make quick edits to your images.

In this article:

Uploading files

Supported file types

The following file types can be uploaded to the Asset Library (or Media Library):

Images

.jpg — maximum file size 20MB
.png — maximum file size 20MB
.webp — maximum file size 2MB
.gif — maximum file size 2MB
.svg — no dimension restrictions

Raster formats (.jpg, .png, .webp, .gif) also have a maximum limit of 40 megapixels (width × height — e.g. 8000 × 5000 px or 6324 × 6324 px).

Lottie Files .lottie
Documents .pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx — maximum file size 20MB
Videos

Foleon Videos: up to 5GB with the following file types:
.mp4
.mov
.webm

YouTube, Vimeo, Wistia, and Brightcove videos can be embedded from a URL

⚠️ You cannot upload password-protected documents.

Upload images, Lottie files, and documents

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

  • Click + Add new media in the top-right corner of either the Asset.
    Drag and drop files into the upload window, or click
    Choose files to select the file(s) from your computer.

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

📖 Learn more about the image element or background images

Add new media to the Media Library

Upload videos

In addition to images and documents, you can upload videos. 
If you have access to Foleon Video, you can upload a video file directly, including vertical video. If not, you can add a video from a URL.

Upload your file with Foleon Videos:
Upload a video file straight to Foleon without relying on an external platform.

    1. Click + Add new media in the top-right corner of the Asset Library or Media Library.
    2. Drag and drop your video file into the upload window, or click Choose files to select the file(s) from your computer. 
    3. Wait for your video to finish uploading.
    4. Double-click the video to open the Preview. Adjust the following as needed:
      1. Adjust the file name and title (for accessibility)
      2. Choose a new fallback image
      3. Upload captions and subtitles

    💡 With Foleon Video, you can also upload vertical videos.

    Drop video files

    Upload a video from a URL (YouTube, Vimeo, Wistia, Brightcove, or Self-Hosted)

    Add a video hosted on YouTube, Vimeo, Wistia, Brightcove, or your own server.

      1. Click + Add new media in the top-right corner of the Asset Library or Media Library.
      2. Select Embed a video from a URL.
      3. Select your video source from the dropdown
      4. Complete the remaining fields, following the guidelines below.

      📖 Learn more about the video element or background videos

      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)

      💡 YouTube Shorts are not currently supported. As a workaround, drag and drop an embed element onto your page and replace "shorts" with "embed" in the video URL. For example: https://www.youtube.com/embed/[VIDEO_ID]

      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.

      💡 If using Cloudflare Stream, use the manifest URL for optimal playback: https://customer-{customer-id}.cloudflarestream.com/{identifier}/manifest/video.m3u8. This enables adaptive streaming for smooth playback across network conditions.

      ⚠️ When embedding videos from a third-party provider, use the direct media link — not an iframe embed URL.

      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 window will open with the file already selected.

      💡 This only works for files stored in Foleon. If the file comes from an integration such as Unsplash, Aprimo, or Bynder, the window will open your most recent folder location.

      Asset selected in the Media Library

      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.

      💡 Asset Usage is available for images and videos only.

      1. Find the file in the Asset Library or 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.

      See asset usage

      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.

      💡 Replace Asset is available for images only.

      1. Find the file you want to replace in the Asset Library or 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.

      ⚠️ Note the following restrictions:

      • The replacement file must be the same file type as the original. If the file type does not match, you will see a Wrong file type error.

      • If the new image has a different aspect ratio than the original, it may affect the layout of Foleon Docs, Templates, and Modules where it is used. Review your content after replacing.
      • Already published Foleon Docs will not update automatically. To apply the change, republish each Doc that contains the new image.

      Replace image in media library

      Download files

      To download a file you've previously uploaded:

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

        Download file from Media Library