Docs Home → Develop Applications → MongoDB Drivers → Node.js
Insert Multiple Documents
Note
If you specify a callback method, insertMany()
returns nothing. If you
do not specify one, this method returns a Promise
that resolves to the
result object when it completes. See our guide on Promises and
Callbacks for more information, or the
API documentation for
information on the result object.
You can insert multiple documents using the
collection.insertMany() method. The insertMany()
takes an array
of documents to insert into the specified collection.
You can specify additional options in the options
object passed as the
second parameter of the insertMany()
method. Specify ordered:true
to prevent inserting the remaining documents if the insertion failed for a
previous document in the array.
Specifying incorrect parameters for your insertMany()
operation can
cause problems. Attempting to insert a field to a value that would violate
unique index rules will throw a duplicate key error
.
Example
Note
You can use this example to connect to an instance of MongoDB and interact with a database that contains sample data. To learn more about connecting to your MongoDB instance and loading a sample dataset, see the Usage Examples guide.
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 async function run() { 9 try { 10 await client.connect(); 11 12 const database = client.db("insertDB"); 13 const foods = database.collection("foods"); 14 15 // create an array of documents to insert 16 const docs = [ 17 { name: "cake", healthy: false }, 18 { name: "lettuce", healthy: true }, 19 { name: "donut", healthy: false } 20 ]; 21 22 // this option prevents additional documents from being inserted if one fails 23 const options = { ordered: true }; 24 25 const result = await foods.insertMany(docs, options); 26 console.log(`${result.insertedCount} documents were inserted`); 27 } finally { 28 await client.close(); 29 } 30 } 31 run().catch(console.dir);
If you run the preceding example, you should see the following output:
3 documents were inserted