JavaScript: upload

Uploads a file to an existing bucket.

Parameters

• path

  (Required)

  The file path, including the file name. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload.

• fileBody

  (Required)

  The body of the file to be stored in the bucket.

• fileOptions

  (Optional)

  Optional file upload options including cacheControl, contentType, upsert, and metadata.

Examples

Upload file

const avatarFile = event.target.files[0]
const { data, error } = await supabase
  .storage
  .from('avatars')
  .upload('public/avatar1.png', avatarFile, {
    cacheControl: '3600',
    upsert: false
  })

Upload file using `ArrayBuffer` from base64 file data

import { decode } from 'base64-arraybuffer'

const { data, error } = await supabase
  .storage
  .from('avatars')
  .upload('public/avatar1.png', decode('base64FileData'), {
    contentType: 'image/png'
  })

Handling errors

const { data, error } = await supabase
  .storage
  .from('avatars')
  .upload('public/avatar1.png', avatarFile)

if (error) {
  // Log the full error so fields like `statusCode` and `error` (the
  // Storage error name, e.g. "Duplicate") aren't hidden behind `error.message`.
  console.error(error)
  return
}