Create an Entry

You can start adding content on your website by creating an entry. 

Note: You can create, update, delete and refer entries only within specific branches of your stack. For example, if you create an entry within the blog content type of the development branch, you will be able to use or access this entry only within the development branch. Refer to our Branch-specific Modules document for more information.

To create an entry, log in to your Contentstack account, go to your stack, and perform the steps given below.

  1. Select a content type

    To create entries, you need to add content to existing content types. Click on the “Content Models” icon on the left navigation panel to view the list of content types available in your stack.

    Content types come in two types: Single and Multiple. A Single content type allows you to create only one entry, while Multiple lets you create multiple entries. Select the appropriate content type to arrive at the Create Entry page.

    Additional Resource: For more information on creating your content type or modifying an existing content type, refer the set of Create and Manage Content Types guides.

  2. Add content

    To add your content, perform the following steps:

    1. Navigate to the entries section by using the shortcut key “E”(for both Windows and Mac users), or click on the “Entries” button on the left navigation panel.
    2. Next, click on the + New Entry button on the top, select the content type, and click on Proceed.
    3. In the Create Entry page, the language selector link on the top-right corner of the page lets you choose the language of the entry. This option plays an important role when you need to create Multilingual content. By default, it is set to “English (United States)” or the master language of your stack.
      Each entry, irrespective of the type of content type selected, has a Title field. Enter a relevant title for the content in this field. For a Webpage content type, you need to add the URL field where you provide the relative path for the page, without the base URL. For example, in https://www.contentstack.com/docs, the base URL is “https://www.contentstack.com”, and “/docs” is the relative path.
    4. There may be additional fields, depending on the kind of content type created by the developer. Enter the relevant content in all the available fields before saving or publishing it.

    Add Content for Multiple Content Type Reference

    If you have added a Reference field that refers to multiple content types, you will be able to add multiple entries as references in a single field. When entering data for a multiple Reference field, you will see the option, Choose existing entry and Create New Entry.

    Note: For existing entries that got an upgrade in their Reference field, you need to save the entries again to see the upgraded field in action. Then, you can start adding entries of multiple content types.

    Choose existing entry

    When entering data for the Reference field, this option will open the Select Entries modal that displays the entries of the referenced content type(s). You need to perform the following steps:

    1. Click on the “Content Type” dropdown at the top-left corner of the modal to select the required content type. You should see one of the referenced Content Type already selected. Change it if you need to.
    2. The entries of the selected content type are displayed from which you can select the entries. Likewise, you can select entries of other content types by switching between content types.

      Note: The maximum number of entries that can be added in a multiple content type referencing “Reference” field is 100. Also, the maximum reference depth limit for a Reference field referencing multiple content types is one level. Refer the Limitations section for more details.

    3. After selecting entries of the referenced content type(s), click on Show selected entries at the top-right side (see above screenshot) to view all the selected entries. You should see the following modal:
    4. Finally, click on Add Selected Entries to add all the selected entries as a reference in the given reference field.

    Create new entry

    You can also create and add new Reference entries on-the-go. This option comes handy in situations where while adding references, you realize that you need to add a new entry that can be used as a reference.

    To do so, perform the following steps:

    1. Click the Create new entry link.

      Warning: Make sure you save the parent entry before you navigate to the new entry page. If the parent entry is not saved, unsaved data may be lost.

    2. In the modal that opens, select the content type from the dropdown for which you want to create a new entry, and click Create.

      This will take you to the new entry page for the content type.

    3. After entering the data for the new entry, click on Save.

    This will create a new entry for the referred content type and will automatically add it under the “Reference” field.

    Beside each referenced entry, you will see the “Edit” and the “Remove” icons (if you have the necessary permissions). Clicking on the “Edit” icon will lead you to the entry page where you can make the necessary changes to the specific entry. The “Remove” icon, as the name suggests, will remove an entry from the list of selected referred entries.

    Finally, it is important to note that each field of a content type accepts a specific data type. To know more about the available fields and their respective data types, visit the Fields page.

  3. Add Tags (Optional)

    You can add tags to an entry. This helps you filter or search your entries quickly.

  4. Preview Entry

    Live Preview is a feature that allows content managers to preview content without publishing it to an environment or saving the changes made to the content. The content changes you make reflect in the preview portal in real-time.


    You can also preview your content changes across multiple channels, such as mobiles, tablets, and desktops.

  5. Save or Publish

    Once the relevant content is added in the content type, click the Save or Publish button. If you choose the Publish option, the Publish Entry dialog box will appear. For more information on publishing entries, see Publish an Entry.

Additional Resource: You can now attach additional metadata to a specific entry without incrementing its version. Refer to the Additional Metadata Support for Entries documentation for more information.

API Reference

Here are some API requests that might help you:

Was this article helpful?