convex-file-storage

Upload, store, serve, and delete files with metadata in Convex apps.

Updated Apr 12, 2026

Search Tags:#metadata #storage #convex #uploads #file-storage #serve-files

Ready to run

npx skills add https://github.com/althof3/TCG-auction --skill convex-file-storage-althof3

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/althof3/TCG-auction/tree/main/.agent/skills/convex-file-storage
Command: npx skills add https://github.com/althof3/TCG-auction --skill convex-file-storage-althof3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex File Storage enables end-to-end handling of files within Convex apps, including uploading, storing, serving via generated URLs, and managing metadata.

Core Features & Use Cases

Upload, store, and serve files with auto-generated URLs.
Read file metadata from the storage system table and track uploads in your app tables.
Delete files and clean up both storage and database records.

Quick Start

Upload a file to Convex storage, retrieve its URL, and save a database reference.

Frequently Asked Questions about convex-file-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I handle file uploads and storage in a Convex app?▼

File storage in a Convex app is managed through built-in storage APIs that handle uploading files to server-side storage. You can retrieve auto-generated URLs to serve the files and save database references to track the uploads.

How does file metadata tracking work with Convex storage?▼

Convex storage tracks file metadata by reading details from the built-in storage system table. You can query this system table to access file information and maintain references to the uploads in your own application database tables.

Can I generate URLs to serve stored files using Convex?▼

Yes, Convex automatically generates URLs for uploaded files, allowing you to serve images, documents, and generated assets directly. These URLs provide access to the files stored within your Convex-based projects.

What is the best way to delete files and clean up database records in Convex?▼

The best way to delete files in Convex is to use server mutations that remove the file from storage and clean up the corresponding database records. This ensures both the stored file and its metadata reference are fully deleted.

How do I secure file uploads and manage access controls in Convex?▼

To secure file uploads in Convex, you need to implement access controls using server mutations. This ensures that only authorized users can upload, serve, or delete files and interact with the storage APIs.