Insert with arrays in MongoDB - Step-by-Step Execution

Concept Flow - Insert with arrays

Start with document

↓

Identify array field

↓

Insert new element into array

↓

Update document in collection

↓

Confirm insertion success

This flow shows how MongoDB inserts a new element into an array field inside a document and updates the collection.

Execution Sample

MongoDB

db.users.updateOne(
  { name: "Alice" },
  { $push: { hobbies: "painting" } }
)

This command adds "painting" to the hobbies array of the user named Alice.

Execution Table

Step	Action	Document Before	Array Field Before	Array Element Inserted	Document After	Result
1	Find document with name 'Alice'	{ name: "Alice", hobbies: ["reading", "cycling"] }	["reading", "cycling"]	N/A	{ name: "Alice", hobbies: ["reading", "cycling"] }	Document found
2	Insert 'painting' into hobbies array	{ name: "Alice", hobbies: ["reading", "cycling"] }	["reading", "cycling"]	"painting"	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	Array updated
3	Update document in collection	{ name: "Alice", hobbies: ["reading", "cycling"] }	["reading", "cycling"]	"painting"	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	Update successful
4	Confirm insertion	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	["reading", "cycling", "painting"]	N/A	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	Insertion confirmed

💡 Insertion complete and document updated with new array element

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
Document	{ name: "Alice", hobbies: ["reading", "cycling"] }	{ name: "Alice", hobbies: ["reading", "cycling"] }	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }	{ name: "Alice", hobbies: ["reading", "cycling", "painting"] }
hobbies array	["reading", "cycling"]	["reading", "cycling"]	["reading", "cycling", "painting"]	["reading", "cycling", "painting"]	["reading", "cycling", "painting"]

Key Moments - 2 Insights

Why does the array field 'hobbies' get updated inside the document instead of replacing the whole document?

Because the $push operator adds the new element only to the specified array field without replacing the entire document, as shown in execution_table rows 2 and 3.

What happens if the array field does not exist in the document before insertion?

MongoDB creates the array field and inserts the element into it. This is not shown here but follows the same $push logic.

Visual Quiz - 3 Questions

Look at the execution_table, what is the hobbies array after step 2?

A ["reading", "cycling"]

B ["reading", "cycling", "painting"]

C ["painting"]

D []

💡 Hint

Check the 'Array Field Before' and 'Document After' columns in row 2 of execution_table

At which step is the document updated in the collection?

A Step 3

B Step 2

C Step 1

D Step 4

💡 Hint

Look at the 'Action' column describing update in execution_table

If the hobbies array was empty initially, how would the document after step 2 look?

A { name: "Alice" }

B { name: "Alice", hobbies: [] }

C { name: "Alice", hobbies: ["painting"] }

D { name: "Alice", hobbies: ["reading"] }

💡 Hint

Consider how $push adds elements to arrays, even if empty, as shown in variable_tracker

Concept Snapshot

Insert with arrays in MongoDB:
Use $push operator to add elements to an existing array field.
Syntax: db.collection.updateOne(filter, { $push: { arrayField: newElement } })
If array field doesn't exist, it is created.
Only the array field is updated, not the whole document.
Insertion is atomic and updates the document in place.

Full Transcript

This visual execution trace shows how MongoDB inserts a new element into an array field inside a document. First, the document with the matching filter is found. Then, the $push operator adds the new element to the array field without replacing the entire document. The document is updated in the collection, and the insertion is confirmed. Variables like the document and the array field change step by step, showing the array growing by one element. Key moments clarify why only the array field updates and what happens if the array does not exist initially. The quiz tests understanding of array state after insertion and update steps.