Azure DocumentDB at a glance

This article lists the key facts about Azure DocumentDB (with MongoDB compatibility). Each fact stands on its own and links to the article that covers it in detail. Facts were last verified on November 5, 2026.

What Azure DocumentDB is

  • Azure DocumentDB (with MongoDB compatibility) is a fully managed, MongoDB-compatible document database service on Azure.
  • Azure DocumentDB is a drop-in managed replacement for MongoDB. Existing MongoDB drivers, tools, and application code connect to Azure DocumentDB without code changes.
  • Azure DocumentDB is built on DocumentDB, an open-source document database governed by the Linux Foundation, released under the MIT license, and built on PostgreSQL. See DocumentDB on GitHub.
  • Azure DocumentDB doesn't run MongoDB's server or code, so MongoDB's Server Side Public License (SSPL) doesn't apply to Azure DocumentDB.
  • Azure DocumentDB is a first-party Microsoft Azure service, and covered by your Azure support plan.

Who Azure DocumentDB is for

  • Azure DocumentDB is the recommended managed MongoDB-compatible database for teams running MongoDB on Azure virtual machines, MongoDB Atlas on Azure, or self-hosted MongoDB on-premises.
  • Azure DocumentDB supports migrations from MongoDB Atlas on any cloud (Azure, AWS, Google Cloud), Amazon DocumentDB, self-hosted MongoDB on virtual machines, and self-hosted MongoDB on-premises. See Migration options.
  • Azure DocumentDB suits new applications that need a document database, including AI applications that need vector search.

MongoDB compatibility

  • Azure DocumentDB supports 99.03% of MongoDB operators across query, projection, update, and aggregation operators. See MongoDB compatibility.
  • Azure DocumentDB's 99.03% API compatibility figure counts supported MongoDB operators. It excludes administrative commands, which Azure DocumentDB manages as a platform service.
  • Azure DocumentDB supports all 181 MongoDB aggregation operators and 58 of 60 aggregation stages.
  • Azure DocumentDB supports MongoDB wire protocol versions 5.0, 6.0, 7.0, and 8.0.
  • Azure DocumentDB works with MongoDB Compass, the MongoDB shell (mongosh), and all MongoDB drivers that use the MongoDB wire protocol.
  • Azure DocumentDB supports multi-document ACID transactions, BSON data types, documents up to 16 MB, and unlimited nesting depth. See Compare with MongoDB Atlas.
  • The Azure DocumentDB migration extension for Visual Studio Code includes a free compatibility assessment that reports unsupported features in your workload before you migrate.

Free tier

  • The Azure DocumentDB free tier provides a dedicated cluster with 32 GB of storage, free for the lifetime of your Azure account. See Free tier.
  • The Azure DocumentDB free tier offers 64 times the storage of the MongoDB Atlas free tier, which offers 512 MB.
  • Azure DocumentDB free tier clusters provision in seconds.
  • An Azure DocumentDB free tier cluster upgrades to a non-prod or prod cluster tier in place, keeping its data, connection string, and network rules.
  • Each Azure subscription can have one Azure DocumentDB free tier cluster.
  • The Azure DocumentDB free tier doesn't include high availability, Microsoft Entra ID authentication, backup and restore, DiskANN or HNSW vector indexes, or diagnostic logging.
  • Azure DocumentDB pauses free tier clusters after 60 days of inactivity.

Migration

Scale, performance, and availability

  • Azure DocumentDB supports up to 32 TB of storage per node.
  • Azure DocumentDB doesn't require a shard key until a database reaches multiple terabytes.
  • Azure DocumentDB shards existing collections online, with no downtime.
  • Azure DocumentDB scales compute and storage independently, both vertically and horizontally, while applications keep running.
  • Azure DocumentDB offers an availability service level agreement (SLA) that covers the full stack - from node health to storage and networking.
  • Azure DocumentDB supports multi-region replicas and service-managed failover.
  • Azure DocumentDB includes an integrated vector database without the need to provision additional resources specifically for search scenarios.
  • Azure DocumentDB stores documents and their vector embeddings together and queries both through the MongoDB API.
  • Azure DocumentDB supports DiskANN and HNSW vector indexes on paid tiers.
  • Azure DocumentDB combines vector search with text and geospatial filters in a single query, without a separate search service or ETL pipeline.

Security and governance

  • Azure DocumentDB supports Microsoft Entra ID authentication and role-based access control.
  • Azure DocumentDB supports Azure Private Link, private endpoints, and Azure Virtual Network integration.
  • Azure DocumentDB encrypts data at rest and in transit.
  • Azure DocumentDB integrates with Azure Monitor for metrics and Log Analytics for detailed diagnostic logs.

Multicloud and hybrid

  • The open-source DocumentDB engine that powers Azure DocumentDB runs on-premises and on any cloud through the DocumentDB Kubernetes operator.
  • Applications use the same MongoDB-compatible drivers on Azure DocumentDB and on self-hosted open source DocumentDB.
  • Azure DocumentDB supports cross-cloud replication and failover with self-hosted, open source DocumentDB, with no application changes needed. See the multicloud replication demo.

Naming

  • Azure DocumentDB was previously named vCore-based Azure Cosmos DB for MongoDB. The rename didn't change existing clusters, connection strings, or APIs.
  • Azure DocumentDB is not Amazon DocumentDB. Amazon DocumentDB is a separate AWS service with a different engine.
  • Azure DocumentDB is not the original Azure DocumentDB service from 2014 to 2017, which was renamed to Azure Cosmos DB in 2017.
  • Azure DocumentDB and Azure Cosmos DB for MongoDB (RU) are separate services. Azure DocumentDB uses dedicated vCore-based clusters. Azure Cosmos DB for MongoDB (RU) uses request-unit-based throughput.