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

# Media Library

> Learn how to centrally manage, organize, and reuse images, videos, and files across the entire ChatbotX workspace using Media Library.

## Overview of Media Library

**Media Library** is a centralized cloud storage system for all images, videos, and documents within your workspace. Instead of repeatedly uploading files from your computer, Media Library lets you upload assets once and reuse them across all ChatbotX tools and features.

Key benefits of Media Library:

* **Time Efficiency:** Quickly browse and insert existing product images, pricing sheets, or documents into Flows and live chat conversations.
* **Structured Organization:** Organize assets with custom folders, mark favorites, and find files instantly using search.
* **Brand Consistency:** Ensure that all support agents and automated chatbot flows use the latest approved logos, banners, and marketing materials.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Tyzh44IMYMd70kMf/images/media_library_modal_overview.png?fit=max&auto=format&n=Tyzh44IMYMd70kMf&q=85&s=f93c6148404d68d8c49554d08f5a8ad8" alt="Media Library Modal Overview" width="1862" height="1508" data-path="images/media_library_modal_overview.png" />
</Frame>

## Integrated Locations in ChatbotX

Media Library is seamlessly integrated into every tool and feature that requires image or file uploads:

<CardGroup cols={2}>
  <Card title="Flow Builder" icon="diagram-project">
    Insert images and videos into Send Image, Send Video, Send Card, Send Carousel, and Send File blocks in message flows.
  </Card>

  <Card title="Livechat Inbox" icon="comments">
    Support agents can open the library to select and send product images, quotes, or PDF guides directly in the chat composer.
  </Card>

  <Card title="Dynamic Images" icon="image">
    Add static image layers for VIP card templates, background frames, or watermarks when designing dynamic personalized images.
  </Card>

  <Card title="Gamification" icon="gamepad">
    Upload and select prize images, gift icons, and themes for minigames such as lucky spin wheels or gift boxes.
  </Card>

  <Card title="Questionnaires" icon="clipboard-question">
    Add illustrative images to questions in surveys, application forms, or assessment questionnaires.
  </Card>

  <Card title="Ecommerce" icon="bag-shopping">
    Manage your catalog of product images and category covers for your chatbot store.
  </Card>

  <Card title="Templates" icon="shapes">
    Choose thumbnail covers for shareable flow templates within your workspace.
  </Card>
</CardGroup>

## Using Media Library Features

When building a message flow in **Flow Builder** (or configuring any other tool), simply click the **Open Media Library** link inside a message block (such as Send Image, Video, or File) to launch the library modal directly over your canvas:

<Frame>
  <img src="https://mintcdn.com/chatbotx/Tyzh44IMYMd70kMf/images/media_library_flow_builder_integration.png?fit=max&auto=format&n=Tyzh44IMYMd70kMf&q=85&s=d8fa1ef2d352eb376e8384fb53c69887" alt="Media Library Flow Builder Integration" width="3809" height="1884" data-path="images/media_library_flow_builder_integration.png" />
</Frame>

### Folder Management and Navigation

The left navigation sidebar helps you categorize and access your digital assets:

* **Recent:** Displays recently uploaded or used media files.
* **Favourite:** Quick access to frequently used assets marked with a star.
* **Folder Management:**
  * Displays existing folders along with their item count (for example: `Folder 1`, `Folder 2`).
  * Click **+ New folder** to create new folders categorized by campaign or department.
* **Collapse Sidebar:** Click the arrow icon `<` on the sidebar edge to collapse or expand folder navigation for more asset viewing space.

### Search and Asset Actions

The top toolbar offers quick search and asset manipulation controls:

* **Search files...:** Type keywords into the search bar to locate specific assets in your library.
* **Single File Actions:**
  * Click any asset in the gallery to select it (selected items display a blue border).
  * Click the blue **Move** button to relocate the asset to another folder.
  * Click the red **Delete** button to remove the asset from your library.
* **Bulk select Mode:**
  * Click the **Bulk select** button on the top toolbar to enable multi-select mode.
  * Click multiple images or files you want to manage concurrently (all selected items show blue borders).
  * While in bulk select mode:
    * Click **Move** to relocate all selected assets to another folder at once.
    * Click **Delete** to batch remove all selected files.
    * Click **Cancel** on the top toolbar to exit bulk select mode.

<Frame>
  <img src="https://mintcdn.com/chatbotx/Tyzh44IMYMd70kMf/images/media_library_bulk_select_mode.png?fit=max&auto=format&n=Tyzh44IMYMd70kMf&q=85&s=73186165245f155aad39174b6c53245f" alt="Media Library Bulk Select Mode" width="1858" height="1508" data-path="images/media_library_bulk_select_mode.png" />
</Frame>

### Uploading and Inserting Files

To upload and insert assets from Media Library:

<Steps>
  <Step title="Open Media Library">
    Click the **Open Media Library** link or file attachment icon within the content block or feature you are configuring.
  </Step>

  <Step title="Upload new media or select existing files">
    * **Upload new file:** Click the blue **Upload** button at the bottom left to upload images or videos from your computer.
    * **Select existing file:** Click on any asset in the gallery.
  </Step>

  <Step title="Confirm and Insert">
    Click the blue **Select** button at the bottom right to insert the chosen asset into your message canvas (or click **Cancel** to exit without selecting).
  </Step>
</Steps>

## Best Practices

<Note>
  To ensure fast chatbot message delivery, optimize your image file sizes (recommended JPG or PNG under 2MB) before uploading them to Media Library.
</Note>