Why Supabase Storage handles file uploads - See It in Action

Why Supabase Storage handles file uploads

📖 Scenario: You are building a simple web app that lets users upload photos. You want to store these photos safely and make them easy to access later.

🎯 Goal: Learn how Supabase Storage manages file uploads to keep your files secure, organized, and accessible.

📋 What You'll Learn

Create a bucket in Supabase Storage to hold files

Configure access permissions for the bucket

Upload a file to the bucket using Supabase client

Retrieve the public URL of the uploaded file

💡 Why This Matters

🌍 Real World

Supabase Storage is used to store user files like images, documents, and videos safely and make them easy to access or share.

💼 Career

Understanding file storage and access control is essential for backend and full-stack developers working with cloud services.

1

Create a bucket in Supabase Storage

Write code to create a bucket called user-photos in Supabase Storage using the Supabase client.

Supabase

// Your code here to create a bucket named 'user-photos'

Hint

Use supabase.storage.createBucket with the exact bucket name 'user-photos'.

2

Set public access for the bucket

Write code to update the user-photos bucket to have public read access using Supabase Storage API.

Supabase

const { data, error } = await supabase.storage.createBucket('user-photos')
// Your code here to update bucket public access

Hint

Use supabase.storage.updateBucket with { public: true } to allow public access.

3

Upload a file to the bucket

Write code to upload a file named profile.jpg to the user-photos bucket using supabase.storage.from('user-photos').upload().

Supabase

const { data, error } = await supabase.storage.createBucket('user-photos')
const { data: updateData, error: updateError } = await supabase.storage.updateBucket('user-photos', { public: true })
// Your code here to upload 'profile.jpg' to 'user-photos'

Hint

Create a File object and upload it using supabase.storage.from('user-photos').upload().

4

Get the public URL of the uploaded file

Write code to get the public URL of profile.jpg from the user-photos bucket using supabase.storage.from('user-photos').getPublicUrl().

Supabase

const { data, error } = await supabase.storage.createBucket('user-photos')
const { data: updateData, error: updateError } = await supabase.storage.updateBucket('user-photos', { public: true })
const file = new File(['file content'], 'profile.jpg', { type: 'image/jpeg' })
const { data: uploadData, error: uploadError } = await supabase.storage.from('user-photos').upload('profile.jpg', file)
// Your code here to get the public URL of 'profile.jpg'

Hint

Use getPublicUrl on the bucket and file name to get the URL.

Practice

1. Why does Supabase Storage use buckets when handling file uploads?

easy

A. To organize files logically and control access

B. To speed up file uploads by splitting files

C. To automatically convert files to images

D. To delete files after upload automatically

Solution

1. Step 1: Understand the purpose of buckets in Supabase Storage

   Buckets are containers that help organize files logically and manage permissions.

2. Step 2: Identify why organization and access control matter

   Organizing files helps keep data tidy and access control ensures security for uploads.

3. Final Answer:

   To organize files logically and control access -> Option A

4. Quick Check:

   Buckets = Organize + Access Control [OK]

Hint: Buckets group files and manage who can see them [OK]

Common Mistakes:

• Thinking buckets speed up uploads
• Believing buckets convert file types
• Assuming buckets delete files automatically

2. Which of the following is the correct way to upload a file to Supabase Storage using JavaScript?

easy

A. supabase.upload('bucket', 'file.txt', file)

B. storage.uploadFile('bucket', file)

C. supabase.storage.from('bucket').upload('path/file.txt', file)

D. supabase.storage.upload('bucket', 'file.txt', file)

Solution

1. Step 1: Recall the Supabase Storage upload method syntax

   The correct method is calling supabase.storage.from(bucketName).upload(path, file).

2. Step 2: Match the syntax with the options

   Only supabase.storage.from('bucket').upload('path/file.txt', file) matches the correct method and parameter order.

3. Final Answer:

   supabase.storage.from('bucket').upload('path/file.txt', file) -> Option C

4. Quick Check:

   Correct upload syntax = supabase.storage.from('bucket').upload('path/file.txt', file) [OK]

Hint: Use .from('bucket').upload(path, file) for uploads [OK]

Common Mistakes:

• Using incorrect method names like uploadFile
• Passing parameters in wrong order
• Skipping the .from('bucket') call

3. What will the following code output if the file upload fails due to permission issues?

const { data, error } = await supabase.storage.from('photos').upload('image.png', file);
console.log(error ? error.message : 'Upload successful');

medium

A. 'Upload successful'

B. An error message explaining permission denied

C. undefined

D. A syntax error

Solution

1. Step 1: Understand the upload result structure

   The upload returns an object with data and error. If upload fails, error contains details.

2. Step 2: Analyze the console.log statement

   If error exists, it prints error.message, which explains the permission issue.

3. Final Answer:

   An error message explaining permission denied -> Option B

4. Quick Check:

   Error present = print error message [OK]

Hint: Check error object to see upload failure reasons [OK]

Common Mistakes:

• Assuming success message always prints
• Expecting undefined when error occurs
• Confusing error object with data

4. Identify the error in this Supabase Storage upload code snippet:

const { data, error } = await supabase.storage.upload('docs', 'file.pdf', file);

medium

A. File variable is undefined

B. Wrong file path format

C. Upload method does not return data

D. Missing .from('docs') before .upload

Solution

1. Step 1: Check the correct method chaining for upload

   The upload method must be called on supabase.storage.from('bucket'), not directly on supabase.storage.

2. Step 2: Identify the missing part in the code

   The code misses the .from('docs') call before .upload.

3. Final Answer:

   Missing .from('docs') before .upload -> Option D

4. Quick Check:

   Use .from('bucket') before upload [OK]

Hint: Always call .from('bucket') before .upload [OK]

Common Mistakes:

• Calling upload directly on storage
• Assuming upload returns no data
• Ignoring file variable initialization

5. You want to upload multiple files securely to Supabase Storage and ensure each file is stored in a separate folder by user ID. Which approach best achieves this?

hard

A. Use one bucket and upload files to paths like 'userID/filename'

B. Create a bucket per user and upload files directly

C. Upload all files to root bucket folder and rename later

D. Upload files without folders and rely on metadata

Solution

1. Step 1: Consider bucket management best practices

   Creating a bucket per user is inefficient and can complicate access control.

2. Step 2: Use folder paths inside a single bucket

   Uploading files to paths like 'userID/filename' inside one bucket organizes files logically and keeps access control manageable.

3. Step 3: Avoid root uploads or relying only on metadata

   Uploading all files to root or relying on metadata makes file management and security harder.

4. Final Answer:

   Use one bucket and upload files to paths like 'userID/filename' -> Option A

5. Quick Check:

   Organize by folder path inside bucket [OK]

Hint: Use folder paths with userID inside one bucket [OK]

Common Mistakes:

• Creating too many buckets
• Uploading all files to root folder
• Ignoring folder structure for security