Skip to main content

Bucket Browser

Location: Sidebar → Bucket Browser

The Bucket Tester is a visual file browser for Supabase Storage, with full support for all storage operations and an RLS debug panel.

Browsing Files

  1. Select a bucket from the list.
  2. Navigate into folders using breadcrumb navigation.
  3. Click any file to view its metadata: size, MIME type, creation date, last modified, and cache control headers.

Performing Operations

All operations respect the currently selected auth context.

OperationHow
Upload a fileClick Upload, select a file from disk.
Download a fileClick the download icon next to any file.
Delete a fileClick the delete icon. Confirmation is required.
Create a folderClick New Folder and enter a name.
Delete a folderRight-click a folder and choose Delete (recursive).
Generate a signed URLClick Signed URL on any file, set an expiry duration.
Preview a fileImage files are displayed inline. Text and JSON files show content directly.
Create a bucketClick New Bucket, set the name and public/private flag.
Delete a bucketSelect the bucket and click Delete Bucket.

RLS Debug Panel

Every operation in the Bucket Tester appends an entry to the RLS Debug Panel, showing:

  • The operation type and file path.
  • The HTTP status code.
  • An interpreted result: Allowed, Denied by RLS, or Denied by Storage Policy.
  • A timestamp and the raw response.

Use this panel to verify that your bucket policies are working as intended by performing operations as different auth contexts and comparing the results.