insertOne.txt

.. _laravel-insert-one-usage:

=================
Insert a Document
=================

.. facet::
   :name: genre
   :values: reference

.. meta::
   :keywords: insert one, add one, code example

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

You can insert a document into a collection by calling the ``create()`` method on
an Eloquent model or query builder.

To insert a document, pass the data you need to insert as a document containing
the fields and values to the ``create()`` method.

Example
-------

This usage example performs the following actions:

- Uses the ``Movie`` Eloquent model to represent the ``movies`` collection in the
  ``sample_mflix`` database
- Inserts a document into the ``movies`` collection

The example calls the ``create()`` method to insert a document that contains the following
information:

- ``title`` value of ``"Marriage Story"``
- ``year`` value of ``2019``
- ``runtime`` value of ``136``

.. io-code-block::
   :copyable: true

   .. input:: ../includes/usage-examples/InsertOneTest.php
      :start-after: begin-insert-one
      :end-before: end-insert-one
      :language: php
      :dedent:

   .. output::
      :language: json
      :visible: false

      {
          "title": "Marriage Story",
          "year": 2019,
          "runtime": 136,
          "updated_at": "...",
          "created_at": "...",
          "_id": "..."
      }

.. include:: /includes/usage-examples/fact-edit-laravel-app.rst

.. tip::

   You can also use the ``save()`` or ``insert()`` methods to insert a document into a collection.
   To learn more about insert operations, see the :ref:`laravel-fundamentals-insert-documents` section
   of the Write Operations guide.