diff --git a/docs/reference/docfx-json-reference.md b/docs/reference/docfx-json-reference.md
index 820682f6cfb..951f6e62344 100644
--- a/docs/reference/docfx-json-reference.md
+++ b/docs/reference/docfx-json-reference.md
@@ -346,6 +346,7 @@ Specifies the output folder of the generated metadata files relative to `docfx.j
 Specifies the generated output file format.
 
 - `mref` (default): output as ManagedReference YAML files.
+- `apiPage`: Output as ApiPage YAML files.
 - `markdown`: Output as common-mark compliant markdown file.
 
 ### `dest`
@@ -433,6 +434,10 @@ Specifies whether private or internal APIs are included in the generated docs. T
 
 Specifies whether explicit interface implementations are included in the generated docs. The default value is `false`.
 
+### `globalNamespaceId`
+
+Specify the name to use for the global namespace. The default value is an empty string.
+
 ## File Mappings
 
 In the short-hand form, these filenames are resolved relative to the directory containing the `docfx.json` file: