MongoDB Create Document

MongoDB provides insert() method to create a new document or insert documents to a collection. If the collection does not already exist, then the insert() method creates the collection and insert document in it.

Syntax of Insert Document

		writeConcern: <document>,
		ordered: <boolean>

The insert() method accepts the following parameters-

Parameter Type Description
document document/ array A single document or documents array to insert into a collection.
writeConcern document It is an optional parameter. It overlooks to utilize the default write concern.
ordered boolean It is an optional parameter. If it is set to true, perform an ordered insertion of the document and if it is set to false, perform an unordered insertion of a document.

The insert categories in three categories -

  • insert()
  • insertOne()
  • insertMany()

insert() Method

It inserts one or more documents into a collection. MongoDB accepts documents in JSON format and in JSON, data represented as key-value pairs and enclosed within curly braces {}.

Example of insert()

> db.students.insert({name:"Zorj Roi", age: 10, class: '5A'});
WriteResult({ "nInserted" : 1 })

Here, 'students' is the collection name. It contains three key and value pairs for storing student data.

The WriteResult returns result status of the insert statement. The nInserted contains number of inserted documents. As in the above example, it has inserted one document.

Let's check how it has inserted document in database-

> db.students.find().pretty();
        "_id" : ObjectId("5d44ec8c4e7b51c3f3698346"),
        "name" : "Zorj Roi",
        "age" : 10,
        "class" : "5A"

As you can see, the _id is inserted automatically. All documents require a primary key stored in the _id field. If we do not provide the _id parameter, then MongoDB automatic assigns unique Object Id to each inserted document.
Here, we have custom generated _id in document insertion using ObjectId() method.

> db.students.insert({"_id": ObjectId("5d44ec8c4e7b51c3f3698346"), "name": "Priska", "age": 11, "class": "6A"});
WriteResult({ "nInserted" : 1 })

insertOne() Method

It is used to insert only one document into a collection. The following example inserts a new document into the students collection.


db.students.insertOne({name: "Rana Soi", age: 11, class: '6B'})

insertMany() Method

It is used to insert multiple documents into a collection. We can pass an array of documents into a collection.


{name: "Andy Joya", age: 10, class: '5A'},
{name: "Mary Soi", age: 11, class: '5B'},
{name: "Priska Somya", age: 12, class: '6A'}

In insertMany(), each document is enclosed in curly braces and separated by comma. It returns a true acknowledgement with Object Ids on success.

        "acknowledged" : true,
        "insertedIds" : [

Insert Large Documents in a Collection

As we know, the MongoDB shell is also a Javascript interpreter. So, we can use Javascript code in MongoDB shell. Suppose, we have to insert numbers from 1 to 50 in a 'Numbers' collection. We can write the code as -

> for(i=1; i<=50; i++){
...{num: i});
... }
WriteResult({ "nInserted" : 1 })
> db.numbers.count();

Show Errors

If you want to show reported error, if any, write the following command. It returns null for no error and error string otherwise.


Difference Between insert() and save()

Both insert() and save() are used to insert the document. The difference with save is that if we passed a document contains an _id field and that _id already exists with a document, then it will be updated instead of inserting a new one.

Read more articles