Deleting documents in Firebase - Step-by-Step Execution

Process Flow - Deleting documents

Start

↓

Identify Document

↓

Call Delete Method

↓

Check Success?

No→Error Handling

Yes↓

Document Removed

↓

End

This flow shows how a document is deleted: find it, delete it, check if successful, then finish.

Execution Sample

Firebase

const docRef = firestore.collection('users').doc('user123');
await docRef.delete();

This code deletes the document with ID 'user123' from the 'users' collection.

Process Table

Step	Action	Document Reference	Result	Notes
1	Create reference to document 'user123'	users/user123	Reference created	Ready to delete
2	Call delete() on document reference	users/user123	Delete request sent	Waiting for confirmation
3	Firestore processes delete	users/user123	Document deleted	Document no longer exists
4	Confirm deletion success	users/user123	Success	No errors
5	End process	-	-	Document removed from database

💡 Deletion confirmed successful, document no longer exists in Firestore

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
docRef	undefined	Reference to users/user123	Same	Same	Same
deleteStatus	undefined	undefined	Pending	Success	Success

Key Moments - 3 Insights

Why do we need to create a document reference before deleting?

Because Firestore needs to know exactly which document to delete. Step 1 in the execution_table shows creating this reference.

What happens if the document does not exist when delete() is called?

Firestore treats delete as successful even if the document is missing, so no error occurs. This is implied in Step 4 where success is confirmed.

Is the delete operation immediate or asynchronous?

It is asynchronous. Step 2 shows sending the delete request, and Step 3 waits for Firestore to process it.

Visual Quiz - 3 Questions

Look at the execution_table, what is the state of 'deleteStatus' after Step 2?

A Pending

B Success

C Undefined

D Failed

💡 Hint

Check variable_tracker column 'After Step 2' for 'deleteStatus'

At which step does Firestore confirm the document is deleted?

A Step 2

B Step 4

C Step 3

D Step 5

💡 Hint

Look at execution_table 'Result' column for when document is deleted

If the document does not exist, what will be the result at Step 4?

A Error

B Success

C Pending

D No result

💡 Hint

Refer to key_moments about delete behavior when document is missing

Concept Snapshot

Deleting documents in Firestore:
1. Create a reference to the document.
2. Call delete() on that reference.
3. The operation is asynchronous.
4. Firestore confirms deletion or no error if missing.
5. Document is removed from the database.

Full Transcript

To delete a document in Firestore, first create a reference to the document you want to remove. Then call the delete() method on that reference. This sends an asynchronous request to Firestore. Firestore processes the request and removes the document if it exists. If the document does not exist, Firestore still treats the operation as successful without error. After confirmation, the document is no longer in the database.