Docs Menu
Docs Home
/ /

Generate an Entity-Relationship Diagram in Atlas

Generate a visualization of your data model as an entity-relationship diagram in Atlas. Entity-relationship diagrams can help you understand and document the relationships between data in your database and plan changes to your schema.

Atlas generates an entity-relationship diagram based on a small sample of documents from each collection you select in your database. Due to this sampling, your diagram might not reflect all fields or relationships in your data.

If you make any changes to your data after you generate a diagram, Atlas doesn't automatically update the diagram. You must create a new diagram to see your changes.

To generate an entity-relationship diagram in Atlas, your database must have at least one collection with data.

1
  1. If it's not already displayed, select the organization that contains your project from the Organizations menu in the navigation bar.

  2. If it's not already displayed, select your project from the Projects menu in the navigation bar.

  3. In the sidebar, click Data Explorer under the Database heading.

    The Data Explorer displays.

Note

You can also go to the Clusters page, and click Data Explorer under the Shortcuts heading.

2

In the left sidebar, click Data Modeling.

3

If you have existing diagrams saved in the Data Modeling tab, you can create a new diagram by clicking Generate new diagram in the upper-right corner of the screen.

4
5

Use the drop-down menu to select which MongoDB connection to use to generate your diagram. The Active label appears under any currently active connection name.

6

Use the drop-down menu to select which database to use for your data model diagram.

7

Use the checkboxes to select which collections to include in your data model diagram.

8

In the Select collections modal, you can choose whether you want Atlas to Automatically infer relationships between collections. When enabled, Atlas analyzes the selected collections and adds relationships based on indexed fields that contain references to other collections.

You can also manually add and edit relationships after you generate your diagram.

Note

Relationships are for annotation purposes only. Atlas does not store relationship information in your MongoDB database.

9

Atlas generates an entity-relationship diagram with the selected collections and displays it in the current tab.

After you generate a diagram, Atlas displays the existing diagrams in the Data Modeling tab.

Back

Visualize Your Data Model

On this page