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.

Upload your file with Foleon Videos:
Upload a video file directly to Foleon without relying on external platforms.

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

    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 and complete the remaining fields outlined 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.

    Add new video to the Media Library

    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