convex-file-storage

Store and serve files in Convex apps with uploads, URLs, and metadata.

1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/blocknavi/convex-batch-processor --skill convex-file-storage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/blocknavi/convex-batch-processor/tree/main/.claude/skills/convex-file-storage
Command: npx skills add https://github.com/blocknavi/convex-batch-processor --skill convex-file-storage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complete file handling including upload flows, serving files via URL, storing generated files from actions, deletion, and accessing file metadata from system tables

Core Features & Use Cases

  • File Upload & Storage: Upload any file type to Convex storage and persist a reference.
  • Serve Files via URL: Generate accessible URLs for stored files and retrieve them for embedding or downloads.
  • Generated Files & Metadata: Manage program-generated files and access metadata from the _storage system table.
  • Deletion & Cleanup: Delete storage items and their database references to keep storage clean.

Quick Start

  • Upload a file to Convex storage and retrieve its serving URL and metadata.

Frequently Asked Questions about convex-file-storage

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

FAQPage Schema
How do I store and serve uploaded files in a Convex app?

To store and serve files in a Convex app, use the built-in storage APIs to upload any file type, persist a reference, and generate accessible URLs for embedding or downloads. This handles the complete upload and serving flow.

How do I access file metadata from the Convex storage system table?

Access file metadata from the Convex _storage system table by utilizing the provided queries. This allows you to retrieve stored file attributes directly within your app to manage generated assets and document details.

Can I manage program-generated files and store them in Convex?

Yes, you can manage program-generated files from actions within Convex. The storage API enables you to persist generated assets directly to storage and retrieve their serving URLs and metadata for later use.

What is the best way to delete files and clean up storage references in Convex?

The best way to clean up storage in Convex is to use the provided mutations to delete storage items alongside their database references. This ensures your storage remains clean and prevents orphaned file references.

Does Convex file storage work for images, documents, and generated assets?

Convex file storage works across images, documents, and generated assets. It provides mutations and queries for uploading any file type, generating serving URLs, and accessing metadata for web apps and content workflows.