WhatsMax DocumentationWhatsMax Documentation
Home
Getting Started
Deployment
Integrations
Platform Guide
FAQ
Home
Getting Started
Deployment
Integrations
Platform Guide
FAQ
  • Getting Started

    • Introduction
    • Requirements
    • Installation
    • Configuration
    • First Steps
  • Production Deployment

    • Production with PM2
    • Nginx & SSL
    • Updating
  • Integrations

    • WhatsApp Cloud API
    • WhatsApp QR
    • Telegram
    • WeChat
    • Social Media
    • Payment Gateways
    • AI Providers
    • E-commerce
    • Webhook Automation
    • SMS & Email
    • Realtime (Pusher)
  • Platform Guide

    • Platform Overview
    • Omnichannel Inbox
    • Templates & Auto Replies
    • Website Chat Widget
    • Contacts & Segments
    • Campaigns & Broadcasting
    • Automations
    • AI Chatbots
    • Social Planner
    • Leads & Pipeline
    • Reports & Analytics
    • Media Library
    • Workspaces & Team
    • Subscription & Support
    • Developer API
  • Admin Panel

    • Admin Panel
    • Clients & Subscriptions
    • Plans, Coupons & Tax
    • Content & Support
    • Configuration
    • System & Health
    • License Activation
  • Reference

    • FAQ
    • Troubleshooting
    • Changelog
    • Credits

Media Library

Developer → Media is the workspace's file store: everything uploaded for messages, templates, campaigns and social posts lives here and can be reused instead of re-uploaded.

Media libraryUploaded files with a live quota bar.

Using it

  • Upload File adds images, video, audio, PDFs and CSVs.
  • Anywhere a file is needed — the inbox composer, a template header, a social post, a campaign — you can pick from the library rather than uploading again.
  • The bar at the top shows used vs quota. The quota comes from the workspace's plan, so it is one of the limits you set when you design your pricing tiers.

Where the files actually live

That depends on STORAGE_DRIVER in .env:

DriverFiles go toNotes
localDisk on the app serverFine for a single server. Back it up with the database.
s3Amazon S3 or any S3-compatible serviceRequired if you run more than one app server. Set AWS_ENDPOINT for DigitalOcean Spaces, MinIO or Cloudflare R2.

See Configuration → File storage.

Deleting is permanent

Removing a file from the library deletes it from storage. Anything already sent keeps working (the recipient has their copy), but a template or scheduled post still pointing at that file will fail at send time.

Prev
Reports & Analytics
Next
Workspaces & Team