Skip to main content

​
What it is

The Assets page (sidebar → Assets) is your workspace’s media library — a place to upload, search, and reuse images, videos, and PDFs across multiple posts without re-uploading every time. It’s also the picker that opens from the post editor when you click “Add media”.

​
Sources

The picker has three tabs: Search and trending feeds are powered by each provider’s official API — results are rendered server-side so your browser never sees raw API keys. When you pick a Giphy or Unsplash result, TryPost downloads the file and saves it as one of your workspace’s assets so it survives even if the original goes away.

​
Uploading

Click Upload to add files from your machine. Supported formats: Max file size: 10 MB for images, 1 GB for videos, 100 MB for PDFs. Files larger than ~1 MB are sent in chunks via Content-Range for reliability on flaky connections.

​
Importing from URL

The post composer also accepts public URLs — TryPost downloads the file server-side, validates the MIME type and size against the enabled platforms on the post, and stores the result. From the API, this is POST /posts/{post}/media/from-url.

​
Searching

The Library tab supports a substring search on the original filename. Unsplash and Giphy use their respective search APIs — pass any keyword phrase. Trending feeds (no query) are also available on both.

​
Reusing assets

Pick an asset in the gallery and it’s attached to the active post. The same asset can be attached to many posts — TryPost references the underlying file rather than copying it. Deleting an asset that’s still in use is blocked from the UI to avoid breaking those posts.

​
Deleting

From the Library tab, click any asset → trash icon. Deletion removes the file from storage and detaches it from the workspace. Posts that referenced the asset will lose the attachment; published posts on social platforms are unaffected.

​
API and MCP

You can list the library and attach an existing file to a post without uploading again. Only this workspace’s library is visible. Viewers cannot list, get, or attach. REST list: 25 per page (page). MCP list: first limit items (default 50, max 100) and has_more — no next page. When you attach, send asset_id. Optional alt replaces image alt text; if you omit alt, the library’s existing alt is kept. Attaching the same file twice does not duplicate it. To add a new file, upload or fetch a URL instead — see Media.

​
Self-hosted

  • Stock-photo and GIF tabs require valid UNSPLASH_ACCESS_KEY and GIPHY_API_KEY in your .env. Without them, those tabs stay disabled — the Library tab works regardless.
  • Files are stored on the disk configured by FILESYSTEM_DISK (defaults to public). For production with multiple instances or heavy media, point this at S3, R2, Spaces, or any S3-compatible service. See the Configuration guide.