How to Update Specific Array Element in MongoDB

To update a specific array element in MongoDB, use the $set operator combined with the positional operator $ in your update query. This lets you target the first matching element in the array and modify its value directly.

Syntax

The basic syntax to update a specific array element uses the $set operator with the positional operator $ inside the array field. The query matches the document and the array element condition, then updates that element.

• filter: Finds the document and the array element to update.
• $set: Specifies the new value for the matched array element.
• arrayField.$: The $ is the positional operator that points to the matched element in the array.

mongodb

db.collection.updateOne(
  { "arrayField.key": valueToMatch },
  { $set: { "arrayField.$.keyToUpdate": newValue } }
)

Example

This example updates the score of a specific player in a players array inside a document. It finds the player with name: 'Alice' and sets her score to 95.

mongodb

db.games.insertOne({
  _id: 1,
  players: [
    { name: 'Alice', score: 80 },
    { name: 'Bob', score: 85 }
  ]
})

// Update Alice's score to 95

const result = db.games.updateOne(
  { 'players.name': 'Alice' },
  { $set: { 'players.$.score': 95 } }
)

// Verify update
const updatedDoc = db.games.findOne({ _id: 1 })
updatedDoc

Output

{
  _id: 1,
  players: [
    { name: 'Alice', score: 95 },
    { name: 'Bob', score: 85 }
  ]
}

Common Pitfalls

Common mistakes when updating array elements include:

• Not using the positional operator $, which causes the whole array to be replaced or no update.
• Using update() instead of updateOne() or updateMany() without proper filters.
• Trying to update multiple array elements at once without arrayFilters (requires MongoDB 3.6+).

Always ensure your filter matches the array element and use $set with arrayField.$ to update the correct element.

mongodb

/* Wrong: Missing positional operator, replaces whole array */
db.games.updateOne(
  { 'players.name': 'Alice' },
  { $set: { 'players.score': 95 } }
)

/* Right: Use positional operator to update only matched element */
db.games.updateOne(
  { 'players.name': 'Alice' },
  { $set: { 'players.$.score': 95 } }
)

Quick Reference

Tips for updating specific array elements in MongoDB:

• Use filter to find the document and array element.
• Use $set with arrayField.$ to update the matched element.
• For multiple elements, use arrayFilters (MongoDB 3.6+).
• Always test updates on sample data first.

Key Takeaways

Use the positional operator $ inside the array field to update the matched element.

Always combine $set with a filter that matches the array element you want to update.

Without the positional operator, updates may replace the entire array or fail.

For updating multiple array elements, use arrayFilters with updateMany or updateOne.

Test your update queries on sample data to avoid unintended changes.