Flutter: Upload a file

Uploads a file to an existing bucket.

• Policy permissions required:
  • buckets permissions: none
  • objects permissions: insert
• Refer to the Storage guide on how access control works

Parameters

• path

  (Required)

  The relative file path. Should be of the format folder/subfolder/filename.png. The bucket must already exist before attempting to update.

• file

  (Required)

  File object to be stored in the bucket.

• fileOptions

  (Optional)

  undefined

• retryAttempts

  (Optional)

  Sets the retryAttempts parameter set across the storage client. Defaults to 10.

• retryController

  (Optional)

  Pass a RetryController instance and call `cancel()` to cancel the retry attempts.

Examples

Upload file

final avatarFile = File('path/to/file');
final String fullPath = await supabase.storage.from('avatars').upload(
      'public/avatar1.png',
      avatarFile,
      fileOptions: const FileOptions(cacheControl: '3600', upsert: false),
    );

Upload file on web

final Uint8List avatarFile = file.bytes;
final String fullPath = await supabase.storage.from('avatars').uploadBinary(
      'public/avatar1.png',
      avatarFile,
      fileOptions: const FileOptions(cacheControl: '3600', upsert: false),
    );