Delete files with Cloud Storage on Web

This page describes how to use the Cloud Storage for Firebase SDK to delete files that have been uploaded to a Cloud Storage bucket.

Delete a file

To delete a file, first create a reference to that file. Then call the delete() method on that reference, which returns a Promise that resolves, or an error if the Promise rejects.

Web

import { getStorage, ref, deleteObject } from "firebase/storage";

const storage = getStorage();

// Create a reference to the file to delete
const desertRef = ref(storage, 'images/desert.jpg');

// Delete the file
deleteObject(desertRef).then(() => {
  // File deleted successfully
}).catch((error) => {
  // Uh-oh, an error occurred!
});

Web

// Create a reference to the file to delete
var desertRef = storageRef.child('images/desert.jpg');

// Delete the file
desertRef.delete().then(() => {
  // File deleted successfully
}).catch((error) => {
  // Uh-oh, an error occurred!
});

Error handling

There are a number of reasons why errors might occur on file deletes, including the file not existing, or the user not having permission to delete the intended file. For more information about errors, see Handle errors.