insertOne & insertMany

insertOne()

Inserts a single document into a collection, creating the collection if it doesn't exist yet.

db.users.insertOne({
  name: "Grace Hopper",
  role: "engineer"
})

Output:

{
  acknowledged: true,
  insertedId: ObjectId("65f1a2b3c4d5e6f7a8b9c0d2")
}

insertMany()

Pass an array of documents to insert several at once.

db.users.insertMany([
  { name: "Alan Turing", role: "mathematician" },
  { name: "Barbara Liskov", role: "engineer" }
])

Output:

{
  acknowledged: true,
  insertedIds: {
    '0': ObjectId("...d3"),
    '1': ObjectId("...d4")
  }
}

Supplying your own _id

You can set _id yourself (e.g. a string or number) as long as it's unique within the collection.