The Media Library is a centralized file manager where you upload, organize, and browse all images and videos for your workspace. A folder-based structure lets you group media by campaign, client, or content type, and a storage quota bar at the top right tracks your current usage. Files stored in the library can be reused across multiple posts without re-uploading.
Opening the Media Library
Click Media Library in the sidebar navigation to open the page. The Media Library is scoped to the current workspace and shows only files and folders that belong to it. You can also access files from the library during post creation by clicking the "Media Library" button in the upload step.
Page Layout
The Media Library page is organized into the following areas:
- Header -- Page title, subtitle, and a storage quota bar on the right
- Folder sidebar (desktop only) -- A tree view of all folders for quick navigation
- Content card -- Breadcrumbs, action bar, subfolder cards, and the media file grid
Storage Quota Bar
In the top-right corner of the header, a horizontal progress bar shows how much storage your workspace is currently using relative to your plan limit. The bar fills from left to right and changes color as usage increases. Hovering over the bar displays the exact byte counts (used and total).
Folder Sidebar
On desktop screens (1024px and wider), a sticky sidebar appears on the left side of the page. It displays a hierarchical tree of all folders in the workspace. Each folder shows its name with a folder icon, and nested subfolders are indented below their parent.
Click on any folder in the tree to navigate directly to it. The currently active folder is highlighted. Click the root level to return to the top-level view showing all root folders and ungrouped files.
On mobile and tablet screens, the sidebar is hidden. Use the breadcrumb navigation and folder cards within the main content area to navigate instead.
Breadcrumb Navigation
At the top of the content card, a breadcrumb trail shows your current position in the folder hierarchy. The root level is always the first item, followed by each nested folder leading to your current location. Click on any breadcrumb segment to jump directly to that folder level.
For example, if you are inside "Campaigns > Summer 2026 > Instagram," clicking "Campaigns" takes you back to that folder, and clicking the root takes you to the top level.
Action Bar
Below the breadcrumbs, an action bar provides three controls:
| Action | Icon | Description |
|---|---|---|
| New Folder | Folder-plus icon | Opens a dialog to create a new subfolder inside the current folder. Enter a name and confirm. |
| Upload | Upload icon | Opens the file picker to select one or more files from your device. Uploaded files are placed in the current folder. |
| Filter | Toggle buttons | Switch between three filter modes: All (images and videos), Images (images only), or Videos (videos only). The active filter is highlighted. |
The filter applies only to media files. Subfolders are always shown regardless of the active filter.
Folder Cards
Subfolders within the current directory are displayed as cards in a responsive grid (1 column on mobile, 2 on tablet, 3 on small desktop, 4 on wide desktop). Each folder card shows the folder icon and name.
Opening a Folder
Click on a folder card to navigate into it. The breadcrumbs update to reflect the new location, and the content area shows the subfolders and files inside the opened folder.
Renaming a Folder
Right-click on a folder card (or use the context menu) and select Rename to open a dialog where you can enter a new name for the folder. Click confirm to apply the change.
Deleting a Folder
Right-click on a folder card and select Delete to open a confirmation dialog. The dialog offers two options:
| Option | What It Does |
|---|---|
| Keep files | Deletes the folder but moves all contained files back to the parent folder. No files are lost. |
| Delete everything | Deletes the folder and permanently removes all files inside it. This action cannot be undone. |
If you are currently viewing the folder that is being deleted, the page navigates back to the root level automatically.
Drag and Drop
You can drag media files onto folder cards to move them into that folder. You can also drag folder cards onto other folder cards to nest one folder inside another. A visual indicator appears when hovering over a valid drop target. The move is processed immediately and the view refreshes.
Media File Grid
Below the folder cards, all media files in the current folder are displayed in a responsive grid. Each file card shows a thumbnail preview (image preview or video first frame) with file metadata.
File Cards
Each media file card includes:
- Thumbnail -- A square preview of the image or the first frame of the video
- File type indicator -- Videos show a "Video" label or play icon overlay
- Delete button -- A small X button in the corner to remove the file from the library
Deleting a File
Click the delete button on any file card to remove it from the media library. The file is permanently deleted from S3 storage and can no longer be used in new posts. The storage quota bar updates immediately to reflect the freed space.
Uploading Files
From the Media Library Page
Click the Upload button in the action bar to open your device's file picker. You can select multiple files at once. Accepted formats are:
| Type | Formats |
|---|---|
| Images | JPEG |
| Videos | MP4, MOV (QuickTime) |
During upload, a full-screen overlay appears with a spinner and "Upload..." text. Files are uploaded to S3 via presigned URLs and then registered in the database with the current folder assignment. The overlay disappears when all files have been processed, and the grid refreshes to show the newly uploaded files.
From the Post Creation Wizard
When creating a post, click the Media Library button in Step 1 (Media) to open a modal showing your library contents. Browse folders and select files to attach them to the current post. Files already attached to the post appear grayed out to prevent duplicates.
Files selected from the library are already stored in S3, so they do not need to be re-uploaded when you schedule or publish the post.
Empty States
When a folder is empty (no subfolders and no files), a centered empty state appears with a folder icon, a heading, a descriptive message, and two action buttons:
- New Folder -- Create a subfolder to start organizing
- Upload -- Add files directly to this folder
This helps new users get started without needing to find the action bar.
Frequently Asked Questions
How do I organize files by campaign?
Create a folder for each campaign using the "New Folder" button. You can nest folders for further organization, such as "Q1 2026 > Instagram > Stories." Drag existing files onto folder cards to move them.
What happens when I delete a file from the library?
The file is permanently removed from S3 storage and from the media library. It cannot be recovered. However, posts that have already been published with that file are not affected, as the platform retains its own copy of the media.
Can I use the same file in multiple posts?
Yes. When you select a file from the media library during post creation, it creates a reference to the same S3 file. The file is not duplicated, so it does not count against your storage quota multiple times.
Is there a file size limit for uploads?
The media library accepts files within the platform validation limits. For images, the maximum size is 30 MB. For videos, the maximum size is 100 MB. Individual platform requirements (such as Instagram's 8 MB limit for photos) are validated during post creation, not during library upload.
How does the storage quota work?
Each workspace has a storage limit determined by the subscription plan. The quota bar in the header shows your current usage as a percentage. When you approach the limit, consider deleting unused files or upgrading your plan.
Next Steps
- Creating a New Post -- Use library files in your next post
- Media Editor -- Edit photos and videos before publishing
- Queue Management -- View and manage your scheduled posts