For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.

Insert a Document Example

You can insert a document into a collection by using the InsertOne() method.

Tip

Read the Usage Examples to learn how to run this example.

This example uses the following Restaurant struct as a model for documents in the restaurants collection:

type Restaurant struct { Name string RestaurantId string `bson:"restaurant_id,omitempty"` Cuisine string `bson:"cuisine,omitempty"` Address interface{} `bson:"address,omitempty"` Borough string `bson:"borough,omitempty"` Grades []interface{} `bson:"grades,omitempty"`}

The omitempty struct tag omits the corresponding field from the inserted document when left empty.

The following example inserts a new document to the restaurants collection:

Tip

Nonexistent Databases and Collections

If the necessary database and collection don't exist when you perform a write operation, the server implicitly creates them.

coll := client.Database("sample_restaurants").Collection("restaurants")newRestaurant := Restaurant{Name: "8282", Cuisine: "Korean"} result, err := coll.InsertOne(context.TODO(), newRestaurant)if err != nil { panic(err)}

View a fully runnable example

After you run the full example, you can find the following inserted document in the restaurants collection:

{ "_id": ObjectId("..."), "name": "8282", "cuisine": "Korean"}

For an example on how to find a document, see the Find a Document usage example.

To learn more about inserting documents, see inserting documents.

InsertOne()

Rate this page