Docs Menu

Docs HomeMongoDB Atlas

Improve Your Schema

On this page

  • Schema Design Patterns
  • Schema Suggestions
  • Limitations of Schema Suggestions

Your schema is the architecture of your cluster, including your collections, indexes and documents. Consider schema design early in the development process.


Serverless instances

You can't access the Schema Advisor for serverless instances.

You can model your schema based on frequently used design patterns. The Building with Patterns blog series discusses the following frequently used design patterns.

To read about situations in which arrays work well, see the following design patterns:

To read about strategies for keeping documents in your working set at a manageable size, see the following patterns:

To learn how to incorporate the flexible data model into your schema, see the following presentations from 2020:

Atlas offers two ways to detect common schema design issues and suggests modifications that follow MongoDB’s best practices:

  • The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries.

  • The Atlas UI offers schema suggestions for a specific collection by sampling documents in that collection.

To learn more about how to apply the suggestions offered in either the Performance Advisor or Data Explorer, refer to the following pages:

Schema Improvement
Reason for Suggestion
You are running too many $lookup operations on your data. Take advantage of MongoDB's rich schema model to embed related data in a single collection.
Your documents contain array fields with many elements, which can degrade query performance.
You have unnecessary indexes in your collection, which can consume disk space and degrade write performance.
You have excessively large documents, which can degrade the performance of your most frequent queries.
You have an exceedingly high number of collections in a database, which can result in unnecessary disk space usage.
You are executing queries that rely on inefficient regex matching. Take advantage of Atlas Search queries that use the $search aggregation pipeline stage.
  • Schema suggestions for a collection are partly driven by a random sampling of documents from that collection. Because this sampling is performed each time your schema is analyzed, you may see different suggestions at different times for the same collection.

  • The Performance Advisor monitors slow queries recognize certain schema issues, namely too many $lookup operations and not utilizing an index for case-sensitive regex queries. If a cluster does not consistently receive long-running queries, the Performance Advisor may not suggest all potential improvements for that cluster, or may not show all reasons why an improvement is being suggested.

  • The Performance Advisor analyzes the 20 most active collections based on the output of the top command. To see suggestions for a specific collection, view that collection in the Atlas UI.

  • Neither Performance Advisor nor Atlas UI provide schema suggestions for time-series collections.

←  Update $text Queries with Atlas Search for Improved Search PerformanceReduce $lookup Operations →
Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.