Atlas Search Compatibility & Limitations

For certain features, Atlas Search might require a specific version of MongoDB. The following table lists the Atlas Search features that require specific MongoDB versions.

Atlas Search Feature	MongoDB Version for Feature
Facets	5.0.4+, 6.0+, 7.0+, 8.0+
Facets on Sharded Clusters	6.0+, 7.0+, 8.0+
Stored Source Fields	5.0.6+, 6.0+, 7.0+, 8.0+
Query Analytics	5.0+, 6.0+, 7.0+, 8.0+
$lookup with $search	6.0+, 7.0+, 8.0+
$unionWith with $search	6.0+, 7.0+, 8.0+
Sort	5.0+, 6.0+, 7.0+, 8.0+
Sort on Sharded Clusters	6.0+, 7.0+, 8.0+
Dedicated Search Nodes	6.0+, 7.0+, 8.0+
Manage search indexes programmatically with mongosh and MongoDB Drivers	6.0+, 7.0+, 8.0+
Atlas Search local deployment with the Atlas CLI	6.0+, 7.0+, 8.0+
`$search` `searchAfter` and `searchBefore` options	6.0.13+, 7.0.5+, 8.0+

Atlas Search is not supported for time series collections.

Supported Clients

To learn about supported clients, see Indexes and Queries.

Atlas Search M0 (Free Cluster), Flex Clusters, M2, and M5 Limitations

The following limitations apply to Atlas Search on M0, M2, M5 Flex clusters only:

You cannot create more than:
- 3 indexes (regardless of the type, search or vector) on M0 clusters.
- 5 indexes on M2 clusters.
- 10 indexes on M5 clusters.
- 10 indexes on Flex clusters.
When you reach the maximum number of indexes allowed for the cluster tier, you can upgrade your cluster tier to create additional indexes. If you upgrade your cluster tier, the indexes are rebuilt on the new cluster tier, which triggers an initial sync.
An index definition JSON object cannot exceed 3KB in size.
An index definition can have only one synonym mapping.
Index builds with more than 300 fields fail.
Lucene's default clause limit of 1024 applies to any BooleanQuery created for searches.
The synonyms collection can't exceed 10,000 documents.
Atlas Search doesn't capture or display query analytics for tracked queries.
Atlas Search doesn't support encrypting Atlas Search indexes with encryption keys using Customer Key Management in the Atlas UI.

Note

You can request new functionality or upvote an existing request using the MongoDB Feedback Engine.

Search Playground Limitations

To learn about Search Playground limitations, see Search Playground Limitations.

Index Limitations

To learn about index limitations, see:

Field Type Limitations

To learn about field type limitations, see:

Query Limitations

Operator Limitations

To learn about query operator limitations, see:

Option Compatibility and Limitations

To learn about query option capatibility and limitations, see:

Back

Multiple Collections

Changelog