[Excel] (Custom functions) Add new JSDoc tags and metadata reference info (#5240)

* [Excel] (Custom functions) Add streaming tags

* Undo changes to autogenerate article

* Add new tags to autogen article

* Add load service description

* Add tags to JSON metadata article

* Add custom enum info to JSON articles

* Add custom enums to manual json article

* Add customEnumType to parameters reference

* Minor edits

* Fix syntax error

* Capitalize Boolean to align with style guide

* Fix incorrect sentence

* Incorporate review feedback

* Fix broken link

* Apply suggestions from code review

Co-authored-by: David Chesnut <[email protected]>

* Add second enum to JSON snippet

* Apply suggestions from code review

Co-authored-by: David Chesnut <[email protected]>

---------

Co-authored-by: David Chesnut <[email protected]>

Author: alison-mk

docs/excel/custom-functions-custom-enums.md

@@ -16,7 +16,7 @@ Custom enums give users Excel AutoComplete options for your custom functions. Th
 Define your enum with the JSDoc tag `@customenum`. The corresponding JSON properties are then autogenerated in your custom function metadata. For more information about JSDoc tags and custom functions, see [Basics of JSDoc tags](custom-functions-json-autogeneration.md#basics-of-jsdoc-tags).
 
 > [!NOTE]
-> Custom enums created with the `@customenum` JSDoc tag are only supported in TypeScript. They are not supported in JavaScript. To use custom enums with JavaScript functions, you must manually create your own JSON metadata. To learn more, see [Manually create JSON metadata](custom-functions-json.md).
+> Custom enums created with the `@customenum` JSDoc tag are only supported in TypeScript. They are not supported in JavaScript. To use custom enums with JavaScript functions, you must manually create your own JSON metadata. To learn more, see [Manually create JSON metadata: enums](custom-functions-json.md#enums).
 
 The following code snippet shows how to define and use a simple custom enum as a parameter.
 

docs/excel/custom-functions-json-autogeneration.md

@@ -1,7 +1,7 @@
 ---
 title: Autogenerate JSON metadata for custom functions
 description: Use JSDoc tags to dynamically create your custom functions JSON metadata.
-ms.date: 06/15/2025
+ms.date: 06/19/2025
 ms.localizationpriority: medium
 ---
 
@@ -92,8 +92,12 @@ In the following example, the phrase "Calculates the volume of a sphere." is the
 The following JSDoc tags are supported in Excel custom functions.
 
 - [@cancelable](#cancelable)
+- [@capturesCallingObject](#capturesCallingObject)
+- [@customenum](#customenum) *{type}*
 - [@customfunction](#customfunction) *id* *name*
+- [@excludeFromAutoComplete](#excludeFromAutoComplete)
 - [@helpurl](#helpurl) *url*
+- [@linkedEntityLoadService](#linkedEntityLoadService)
 - [@param](#param) *{type}* *name* *description*
 - [@requiresAddress](#requiresAddress)
 - [@requiresParameterAddresses](#requiresParameterAddresses)
@@ -114,6 +118,20 @@ If the last function parameter is of type `CustomFunctions.CancelableInvocation`
 
 A function can't have both `@cancelable` and `@streaming` tags.
 
+<a id="capturesCallingObject"></a>
+
+### @capturesCallingObject
+
+This tag works with Excel [data types](excel-data-types-overview.md). It specifies that the data type being referenced by the custom function is passed as the first argument to the custom function. For more information, see [Reference the entity value as a calling object](excel-add-ins-dot-functions.md#reference-the-entity-value-as-a-calling-object).
+
+<a id="customenum"></a>
+
+### @customenum
+
+Syntax: @customenum *{type}*
+
+This tag indicates that a set of values is a custom enum. For more information, see [Create custom enums for your custom functions](custom-functions-custom-enums.md).
+
 <a id="customfunction"></a>
 
 ### @customfunction
@@ -183,6 +201,14 @@ In the following example, the phrase "A function that adds two numbers" is the d
  */
 ```
 
+<a id="excludeFromAutoComplete"></a>
+
+### @excludeFromAutoComplete
+
+The `@excludeFromAutoComplete` tag ensures that the custom function doesn't appear in the formula AutoComplete menu in Excel. For more information, see [Exclude custom functions from the Excel UI](excel-add-ins-dot-functions.md#exclude-custom-functions-from-the-excel-ui).
+
+A function can’t have both `@excludeFromAutoComplete` and `@linkedEntityLoadService` tags.
+
 <a id="helpurl"></a>
 
 ### @helpurl
@@ -202,6 +228,14 @@ In the following example, the `helpurl` is `http://www.contoso.com/weatherhelp`.
  */
 ```
 
+<a id="linkedEntityLoadService"></a>
+
+### @linkedEntityLoadService
+
+The `@linkedEntityLoadService` tag designates that the function is a linked entity load service that returns [linked entity cell values](excel-data-types-linked-entity-cell-values.md) for linked entity IDs requested by Excel.
+
+A function can’t have both `@excludeFromAutoComplete` and `@linkedEntityLoadService` tags.
+
 <a id="param"></a>
 
 ### @param