diff --git a/docs/docs.trychroma.com/markdoc/content/integrations/embedding-models/openai.md b/docs/docs.trychroma.com/markdoc/content/integrations/embedding-models/openai.md
index 4a74ee0956a..bf4134e5633 100644
--- a/docs/docs.trychroma.com/markdoc/content/integrations/embedding-models/openai.md
+++ b/docs/docs.trychroma.com/markdoc/content/integrations/embedding-models/openai.md
@@ -42,7 +42,10 @@ openai_ef = embedding_functions.OpenAIEmbeddingFunction(
                 api_base="YOUR_API_BASE_PATH",
                 api_type="azure",
                 api_version="YOUR_API_VERSION",
-                model_name="text-embedding-3-small"
+                model_name="text-embedding-3-small",
+                # deployment_id is required for Azure OpenAI and newer SDK versions
+                # This parameter specifies the deployment name created in Azure OpenAI Studio
+                deployment_id="DEPLOYMENT_ID",
             )
 ```