From d5060e0b141008eeb87b99c32288bb891f560434 Mon Sep 17 00:00:00 2001 From: Adebayo Ajayi <54339202+Braggedtooth@users.noreply.github.com> Date: Fri, 1 Aug 2025 13:36:51 +0200 Subject: [PATCH] Update deployment.mdx add warning about Cosmos dB incompatibility --- docs/production/deployment.mdx | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/production/deployment.mdx b/docs/production/deployment.mdx index 1865133eced..9cb747975a1 100644 --- a/docs/production/deployment.mdx +++ b/docs/production/deployment.mdx @@ -82,8 +82,13 @@ unsupported `$facet` aggregation. ### CosmosDB -When using Azure Cosmos DB, an index is needed for any field you may want to sort on. To add the sort index for all -fields that may be sorted in the admin UI use the [indexSortableFields](/docs/configuration/overview) option. + + **Warning:** + +While Azure Cosmos DB offers a MongoDB API it is not fully compatible with Payload. Due to strict and limited indexing behavior, many core features may not work reliably. For more details, see the [MongoDB driver's CosmosDB compatibility documentation](https://www.mongodb.com/docs/drivers/cosmosdb-support/#compatibility). + + +To improve compatibility with Azure Cosmos DB, you can activate automatic indexing of all sortable top-level fields by adding the [`indexSortableFields`](/docs/configuration/overview) option to your database adapter configuration. ## File storage