Table of Contents
What This Feature Does #
The Media Library is a shared file repository for your organization. It stores images, videos, documents, and other files that you can reuse across email templates, WhatsApp templates, and other modules.
When to Use #
- Use when creating email templates that need images.
- Use when creating WhatsApp templates with media headers.
- Use when composing direct emails with attachments.
- Do not save sensitive personal documents in the media library — it is a shared asset library.
Prerequisites #
- CompanyAdmin or TenantUser role.
- Pro plan.
- Storage quota available (your plan’s media storage limit).
How to Open the Media Library #
The Media Library opens as a modal popup from within other features (email editor, WhatsApp template builder). There is no standalone media page by default — you access it from the context where you need to pick a file.
Browsing Existing Files #
- When prompted to select a file (e.g., in the email editor), the Media Library popup opens.
- Click the Browse Existing Files tab.
- Use the Search Files box to find by file name.
- Use the File Type Filter dropdown to narrow to Images, Videos, Documents, or All.
- Scroll down to load more files (infinite scroll).
- Click a file card to select it. A checkbox overlay appears.
- Click Confirm Selection (blue button).
Uploading New Files #
- In the Media Library popup, click the Upload New Files tab.
- Drag and drop files or click to select.
- The file is uploaded and appears in the library.
- Select it and click Confirm Selection.
File Thumbnails #
- Images: Preview shown directly on the card.
- Videos: Video thumbnail or file-type icon.
- Documents (PDF, DOCX, etc.): File-type icon with file name, size, and upload date.
Errors #
| Message | Why It Happens | How to Fix |
|---|---|---|
| Storage limit reached | Your plan’s media storage limit is used up | Delete unused files or upgrade your plan |
| File type not allowed | File type not permitted by the caller context | Use an allowed file type (e.g., images for WhatsApp header) |
| Upload failed | Network or server error | Retry the upload |