Supabase Storage

S3-compatible object storage with a global CDN, image transformations, and three purpose-built bucket types.

Supabase Storage is an open source object store that integrates natively with Supabase Auth and Postgres. It supports three bucket types for different workloads: files (general assets), analytics (Apache Iceberg), and vector (embeddings).

Key Features

• S3-compatible: standard S3 API, works with existing S3 tools and SDKs
• Global CDN: assets served from 285+ cities worldwide for low-latency delivery
• Image transformations: resize, crop, and compress images on the fly via URL parameters
• Row Level Security: access policies written in SQL using Postgres RLS, integrated with Supabase Auth
• Dashboard: drag-and-drop uploads, file browsing, multi-select operations, folder management

Bucket Types

Files Buckets

For everyday assets and user content: images, videos, documents, PDFs, archives. Served from the global CDN with fine-grained access controls via RLS policies.

Analytics Buckets

For large-scale analytical workloads on open table formats (Apache Iceberg). Designed for historical data, time-series data, logs, and ETL outputs. Optionally queryable via Postgres.

Vector Buckets

For AI/ML workloads. Store and index vector embeddings with multiple distance metrics, metadata filtering, and fast similarity queries for RAG systems and AI-powered search.

Technical Details

• Protocol: S3-compatible API
• CDN: 285+ global edge locations
• Max file size: 50 MB (Free), 500 GB (Pro/Team/Enterprise), via multipart upload
• Image transformations: resize, crop, format conversion (WebP, AVIF)
• Authorization: Postgres RLS policies on storage.objects table

Links

• Documentation: https://supabase.com/docs/guides/storage
• API Reference: https://supabase.com/docs/reference/javascript/storage-from-upload
• Dashboard: https://supabase.com/dashboard