> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Media & Media Generation

> Upload, manage, and generate images and videos for your store

## Overview

The Knot Media Library is your central hub for managing all visual assets and generating new content with AI. Upload your own images and videos, or create stunning visuals using our AI-powered generation tools.

<Frame caption="Media library interface showing uploaded and generated content">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/knot-6961b7be/images/media-library-overview.png" alt="Media Library Overview" style={{width: '100%', maxWidth: '900px', margin: '20px 0'}} />
</Frame>

## Storage Limits

| Plan | Storage Capacity |
| ---- | ---------------- |
| Free | 50 MB            |
| Paid | 2 GB             |

<Note>
  **Storage Tip**: Generated content counts towards your storage limit. Consider downloading and backing up important assets regularly.
</Note>

## Uploading Media

### How to Upload

<Steps>
  <Step title="Click the Add button">
    Click the "Add" button to reveal the upload drop zone
  </Step>

  <Step title="Drag and drop or browse">
    * Drag one or more files into the drop zone
    * Or click to browse and select files from your computer
  </Step>

  <Step title="Wait for upload">
    Files will upload automatically and appear in your library when complete
  </Step>
</Steps>

### Supported Formats

* **Images**: JPG, PNG, GIF, WebP, SVG
* **Videos**: MP4, WebM, MOV (up to 100MB per file)

<Tip>
  **Best Practices:**

  * Optimize images before uploading to save storage space
  * Use WebP format for better compression without quality loss
  * Keep videos under 30 seconds for faster loading
</Tip>

## AI Media Generation

Click the "Generate" button to open the AI generation drawer with powerful creation tools.

<Frame caption="AI generation interface with model selection and preview">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/knot-6961b7be/images/ai-generation-drawer.png" alt="AI Generation Drawer" style={{width: '100%', maxWidth: '700px', margin: '20px 0'}} />
</Frame>

### Generation Models

#### Cost Effective

Budget-friendly option for quick iterations and drafts:

* **Text-to-Image**: Create images from text descriptions
* **Context + Text-to-Image**: Generate images based on existing images plus text
* **Text-to-Video**: Create short videos from text prompts

#### Best Quality

Premium models for production-ready content:

* **Text-to-Image**: High-resolution, detailed image generation
* **Context + Text-to-Image**: Advanced contextual generation with superior quality
* **Text-to-Video**: Professional-grade video generation

### AI Tools

Additional tools for enhancing your media:

* **Upscaler**: Increase image resolution up to 4x
* **Background Remover**: Remove backgrounds from product images

### Image Generation Options

#### Size Presets

Choose from common aspect ratios:

* **1:1** - Square (Instagram posts, product thumbnails)
* **16:9** - Widescreen (hero banners, video thumbnails)
* **9:16** - Portrait (mobile stories, vertical banners)
* **4:3** - Standard (blog images, galleries)
* **Custom** - Define your own dimensions

<Info>
  **Credit System**: Different models consume different amounts of credits:

  * Cost Effective models: 1 credit per generation
  * Best Quality models: 3 credits per generation
  * Tools: 1 credit per use
</Info>

### Generation Process

<Steps>
  <Step title="Select your model">
    Choose between Cost Effective or Best Quality based on your needs
  </Step>

  <Step title="Choose generation type">
    Select Text-to-Image, Context + Text-to-Image, or Text-to-Video
  </Step>

  <Step title="Configure settings">
    * Enter your prompt
    * Select image size (for image generation)
    * Upload context image (if using Context mode)
  </Step>

  <Step title="Generate">
    Click "Generate" and watch the preview window for results
  </Step>

  <Step title="Save to library">
    Generated content is automatically saved to your media library
  </Step>
</Steps>

### Video Generation Queue

<Warning>
  **Video Generation Time**: Video generation can take several minutes. A queue system shows your progress, allowing you to continue working while videos process in the background.
</Warning>

<Frame caption="Video generation queue showing progress and estimated time">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/knot-6961b7be/images/video-queue.png" alt="Video Generation Queue" style={{width: '100%', maxWidth: '600px', margin: '20px 0'}} />
</Frame>

## Using Media in Your Store

Once media is in your library (uploaded or generated), you can easily apply it to your store:

### Quick Application

1. Select any image or video from your library
2. Click "Insert to Chat"
3. Ask the AI to apply it: "Use this image as my hero banner" or "Add this video to my product page"

### Common Use Cases

* **Hero Banners**: "Apply this image as the main banner on my homepage"
* **Product Images**: "Use these images for my featured products"
* **Background Videos**: "Set this video as the background for my landing section"
* **Gallery Updates**: "Add these images to my gallery section"

<Tip>
  **Pro Tip**: You can select multiple images and ask the AI to create a gallery or carousel with them in one command.
</Tip>

## Managing Your Library

### Organization Features

* **Search**: Find media by filename or type
* **Filter**: View only images, videos, or generated content
* **Sort**: Arrange by date, name, or file size
* **Delete**: Remove unwanted files to free up space

### Media Details

Click on any media item to view:

* File information (size, dimensions, format)
* Generation details (for AI-generated content)
* Usage locations (where it's used in your store)

## Best Practices

### For Uploads

1. **Optimize before uploading**: Compress images to save storage
2. **Use appropriate formats**: WebP for images, MP4 for videos
3. **Maintain consistency**: Keep similar dimensions for related images

### For AI Generation

1. **Start with Cost Effective**: Test your ideas before using Best Quality
2. **Be specific in prompts**: Detailed descriptions yield better results
3. **Use context images**: Maintain brand consistency with Context mode
4. **Plan video generation**: Start video generation before other tasks

### Storage Management

1. **Monitor usage**: Check your storage regularly
2. **Delete unused assets**: Remove old or unused media
3. **Download backups**: Save important generated content locally
4. **Upgrade when needed**: Consider paid plans for more storage

<Note>
  **Coming Soon**: Batch operations, folders for organization, and direct integration with popular stock photo services.
</Note>