F1
Fig1 SDK

Media Library

The Media Library is your central hub for managing all files, images, videos, and documents. Organize assets into folders, upload with drag-and-drop, and enable AI indexing for videos.

Accessing the Media Library

  1. Navigate to your site in the Fig1 dashboard
  2. Click CMS in the left sidebar
  3. Select the Media tab

Interface Overview

The Media Library interface consists of:

  • Toolbar - View toggle, upload button, search, filters
  • Folder Sidebar - Hierarchical folder navigation
  • Content Area - Grid or list view of files
  • File Details - Preview and metadata panel

Uploading Files

Drag and Drop

  1. Open the Media Library
  2. Drag files from your computer onto the content area
  3. Files will upload with progress indicators
  4. Once complete, files appear in the current folder

Upload Button

  1. Click the Upload button in the toolbar
  2. Select files from the file picker
  3. Choose a destination folder (optional)
  4. Click Upload to start

Supported File Types

| Category | Extensions | Max Size | |----------|------------|----------| | Images | JPG, PNG, GIF, WebP, SVG | 10 MB | | Videos | MP4, WebM, MOV | 500 MB | | Documents | PDF, DOCX, TXT, MD | 50 MB | | Audio | MP3, WAV, M4A | 100 MB |

Folder Organization

Creating Folders

  1. Click the New Folder button in the sidebar
  2. Enter a folder name
  3. The slug is auto-generated (you can customize it)
  4. Optionally add a description
  5. Click Create

Nested Folders

Create subfolders to build a hierarchy:

  1. Select a parent folder in the sidebar
  2. Click New Folder
  3. The new folder is created inside the selected folder

Example structure:

/
├── products/
│   ├── electronics/
│   ├── clothing/
│   └── accessories/
├── blog/
│   ├── featured/
│   └── thumbnails/
└── videos/
    ├── tutorials/
    └── demos/

Moving Files

  1. Select one or more files
  2. Click the Move button in the toolbar
  3. Choose the destination folder
  4. Click Move to confirm

Folder Actions

Right-click a folder or use the menu to:

  • Rename - Change the folder name
  • Edit - Update description, color, icon
  • Delete - Remove the folder (files are preserved)

File Management

Selecting Files

  • Single click - Select one file
  • Ctrl/Cmd + click - Add to selection
  • Shift + click - Select range
  • Ctrl/Cmd + A - Select all in current folder

Bulk Actions

With files selected, the toolbar shows:

  • Move - Move to another folder
  • Delete - Remove selected files
  • Download - Download as ZIP (coming soon)

File Details

Click a file to open the details panel:

  • Preview - Image/video preview
  • Filename - Original and stored name
  • Type - MIME type
  • Size - File size
  • Dimensions - For images/videos
  • CDN URL - Direct link to the file
  • Created - Upload timestamp

Copying URLs

  1. Select a file
  2. In the details panel, click the Copy URL button
  3. The CDN URL is copied to your clipboard

Video AI Indexing

Enable AI-powered search and Q&A for your videos.

Enabling AI Indexing

  1. Upload or select a video file
  2. In the file details panel, find AI Indexing
  3. Toggle Index for AI to ON
  4. Optionally configure analysis settings:
    • Segment Duration - How long each chunk is (default: 60s)
    • Detect Techniques - Domain-specific recognition
    • Extract Audio - Enable transcription
  5. Click Start Processing

Processing Status

While processing, you'll see:

  • Progress bar - Overall completion percentage
  • Stage - Current processing step
  • Estimated time - Time remaining

Processing stages:

  1. Queued - Waiting to start
  2. Uploading - Sent to processor
  3. Processing - Analyzing content
  4. Completed - Ready for AI search

What Gets Indexed

When a video is indexed:

  • Visual content - Scene descriptions, on-screen text
  • Audio - Full transcription of speech
  • Timestamps - Each segment linked to its time code
  • Techniques - Domain-specific content detected

Querying Indexed Videos

Once indexed, your AI agent can answer questions like:

  • "What topics are covered in the tutorial?"
  • "At what point does the video discuss [topic]?"
  • "Summarize the main points from the demo"

The agent will reference specific timestamps when relevant.

Learn more about Video AI →

Search and Filters

Search

Use the search bar to find files by:

  • Filename
  • File type
  • Folder name

Filters

Filter the view by:

  • Type - Images, Videos, Documents, Audio
  • Date - Upload date range
  • Size - File size range
  • AI Status - Indexed, Processing, Not indexed

View Options

Grid View

  • Large thumbnails for visual browsing
  • Best for images and videos
  • Shows filename below thumbnail

List View

  • Compact rows with details
  • Shows name, type, size, date
  • Best for document management
  • Sortable columns

CDN and Image Transformations

All uploaded files are served via a global CDN for fast delivery.

Image Transformations

Add query parameters to image URLs for on-the-fly transformations:

https://cdn.fig1.ai/sites/abc/image.jpg?w=400&h=300&fit=cover

| Parameter | Description | Example | |-----------|-------------|---------| | w | Width in pixels | w=400 | | h | Height in pixels | h=300 | | fit | Resize mode | cover, contain, fill | | q | Quality (1-100) | q=80 | | f | Format | webp, avif, jpg |

Example Transformations

// Thumbnail (200x200, cropped)
?w=200&h=200&fit=cover

// Responsive (max 800px wide)
?w=800

// WebP format, 80% quality
?f=webp&q=80

// Hero image (1200x400, cropped)
?w=1200&h=400&fit=cover

API Integration

Access the Media Library via SDK:

// List folders
const folders = await fig1.assets.listFolders();

// Get folder tree
const tree = await fig1.assets.listFolders({ tree: true });

// Create folder
const folder = await fig1.assets.createFolder({
  name: 'Product Images',
  slug: 'product-images'
});

// Upload file
const cdnUrl = await fig1.assets.upload(fileBuffer, {
  filename: 'product.jpg',
  contentType: 'image/jpeg',
  folderId: folder.id
});

// Process video for AI
const job = await fig1.knowledge.processVideo({
  videoUrl: cdnUrl,
  fileName: 'tutorial.mp4',
  analysisConfig: {
    segmentDuration: 60,
    extractAudio: true
  }
});

See the Assets API Reference for complete documentation.

Best Practices

  1. Create a folder structure early - Plan your organization before uploading
  2. Use descriptive filenames - Makes search and management easier
  3. Index important videos - Only process videos users will ask about
  4. Use image transformations - Serve optimized images for different contexts
  5. Clean up unused files - Remove files no longer in use

Troubleshooting

Upload Fails

  • Check file size limits (see table above)
  • Verify the file type is supported
  • Try a smaller file or different format

Video Processing Stuck

  • Check the processing status for error messages
  • Very long videos may take longer
  • Contact support if stuck for over 30 minutes

File Not Appearing

  • Refresh the page
  • Check you're in the correct folder
  • Wait a moment for upload to complete