Skip to main content

Documentation

Learn how to use the Headless platform

Media Library

3 min read

Upload and manage files for use in your content.

Uploading Files

  1. Navigate to Media in your project
  2. Click Upload or drag files into the library
  3. Supported formats:
    • Images: JPG, PNG, GIF, WebP, SVG
    • Documents: PDF, DOC, DOCX
    • Videos: MP4, WebM
    • Other: Any file type

View Options

Toggle between two display modes:

  • Grid View: See thumbnails in a card layout (includes PDF thumbnails)
  • List View: See files in a detailed table format

Image Lightbox

Click on any image thumbnail to open a full-size lightbox view. Use keyboard shortcuts:

  • Escape: Close lightbox
  • Left/Right arrows: Navigate between images

Organizing with Folders

Keep your assets organized using folders:

Creating Folders

  1. Click New Folder in the media library
  2. Enter a folder name
  3. Click Create
  • Click on a folder to open it
  • Use the breadcrumb navigation to go back to parent folders
  • Click the home icon to return to the root level

Moving Assets

  1. Open an asset's detail page
  2. Use the folder selector to move it to a different folder
  3. Click Save

Multi-Select & Batch Operations

Select multiple assets for batch operations:

  1. Click the checkbox on any asset to enter selection mode
  2. Select additional assets by clicking their checkboxes
  3. Use the batch action bar to:
    • Delete selected: Remove multiple assets at once
    • Move to folder: Organize multiple assets together
  4. Click "Clear selection" to exit selection mode

Managing Assets

  • View Details: Click an asset to see full details including:
    • File size and dimensions (for images)
    • MIME type
    • Upload date
    • Alt text (for accessibility)
    • PDF preview (for PDF documents)
  • Copy URL: Get the direct link to the asset
  • Delete: Remove from library

Using Media in Content

  1. Edit a content entry
  2. Click the media field
  3. Select from library or upload new
  4. Click Select

Filtering and Sorting

Use the search bar to find assets by filename or alt text.

Filter

Filter assets by:

  • File type: Images, videos, documents, or all files
  • Folder: View assets in a specific folder

Sort

Sort assets by:

  • Upload date (newest or oldest)
  • Filename (A-Z or Z-A)
  • File size (largest or smallest)

Image Optimization

Uploaded images are automatically:

  • Served via CDN for fast delivery
  • Available for use in responsive content

Deleting Assets

Warning: Deleting an asset may break content entries using it.

  1. Click on the asset to open details
  2. Click Delete
  3. Confirm the deletion