Media library
The Media Library stores the files you attach to posts. Upload a file once and pick it again in any post. You need media.view to open the page. Contributors, Editors, Admins, and Owners all have it.
How do I upload files to the media library?
- Open Media Library and click Upload.
- In the "Upload Media" dialog, choose a file. Accepted types are images, videos, and PDF documents. The dialog notes a maximum file size of 500MB.
- Wait for "Uploading..." to finish. The file appears at the top of the grid.
You can also upload from inside the composer, on the Upload from Device tab of the media picker. Your plan has a storage cap and uploads fail when it is full. See Usage and billing.
How do I find a file?
- Tabs: All, Images, Videos, Documents.
- A Search media... box filters by name.
- A grid and list toggle changes the layout. Newest files come first.
Click a file to preview it. The preview shows how many posts use it ("3 posts") and has a copy-URL action that toasts "URL copied to clipboard".
How do I delete media?
Delete one file from its preview, or click Select, tick several, and click Delete (n). A confirmation says "This permanently removes the file from your library." Deleting frees storage.
How do I reuse a file in a new post?
In the composer, click the media area. The picker has two tabs, Upload from Device and Media Library. Open Media Library and select one or more files. A post's per-platform limits apply, for example the number of images in a carousel. See Composing and publishing.
How do I use the library from code?
| Surface | Command |
|---|---|
| CLI | socifyr media (CLI media) |
| SDK | media resource (SDK media) |
| REST | POST /api/media/upload, GET /api/media (Media API) |
| MCP | list_media, delete_media |
Concepts and ID rules are in Media library concepts.
Storage by plan
Limits come from the shared plan configuration.
| Plan | Storage |
|---|---|
| Free | 1 GB |
| Pro | 50 GB |
| Business | 500 GB |
Common problems
| Symptom | Fix |
|---|---|
| Upload fails with a storage message | "Storage limit reached for your plan. Delete unused media or upgrade to continue." |
| File type rejected | Use an image, video, or PDF. |
| Video will not attach to a platform | Check the platform's size and duration limits on its platform page. |