Skip to main content
Store and manage images, videos, PDFs, and any other file/media assets for your app. Every file gets a permanent CDN URL for fast loading anywhere in the world.
Files and media management

​
How do I upload files?

  1. Open Files & Media tab in the sidebar
  2. Drag and drop files or click the upload button
Your files will upload then appear in your library with metadata and a CDN URL

​
What’s the URL for my file?

All files are accessible at a url like https://cdn.hercules.app/<file_id>

​
How do I integrate files uploaded to Hercules Files & Media into my app?

You can ask Hercules to find files for you. e.g. Add my logo from Hercules files and media to the nav bar
Individual items
Copy the file URL from the Hercules Files & Media tab and paste it into the Hercules Chat Multiple items
  1. Use the checkboxes to bulk select the files/media you want
  2. Click “Add to Chat”
Files and media management

​
What file types are supported?

Everything! Popular ones include
  • Images: PNG, JPG, GIF, SVG, WebP
  • Videos: MP4, WebM, MOV
  • Documents: PDF, DOC, DOCX, XLS, XLSX
  • Other: Any file type can be stored and served.

​
Are there any limits?

Currently the limits are:
PlanStorageUpload Limit
Free50mb5mb
Pro2 GB30mb
Business20 GB30mb
EnterpriseCustomCustomer
If you are on the Business plan and need more storage, please click “Report an issue” with your app and why you need more storage and someone will get back to you.

​
How do I resize images?

Hercules Files and Media URLs lets you use use Cloudflare image transformations. This uses URL parameters to resize the image. Example to make an image 512 wide: https://cdn.hercules.app/cdn-cgi/image/w=512,quality=85,fit=scale-down,format=auto/<file_id>

​
Additional FAQ

Yes. All files uploaded to Files & Media get public CDN URLs. Don’t upload sensitive documents that shouldn’t be publicly accessible.
Currently, each upload creates a new URL. To update an asset, upload the new version, then update references in your app. We’re working on versioned replacements.
Shift-click to select multiple files, then use the bulk delete action. Useful for cleanup after large imports.
Use clear naming conventions: category-name.ext like hero-landing.png, icon-settings.svg, doc-terms-of-service.pdf. Add descriptions for important assets.
Check that you’re using the correct CDN URL. If using image transformations, verify the syntax. Clear browser cache and try again. If issues persist, re-upload the file.
Files & Media stores static assets like images and documents. The Database stores structured app data like user profiles and records. Use Files & Media for assets, Database for data.
Content Management stores editable marketing content like blog posts and page copy. Files & Media stores the actual assets (images, PDFs, videos) those pages reference.