[WXP] Document Context Menu requirement set (#2182)

samantharamon · web-flow · commit e302c2810117 · 2025-03-07T12:22:50.000-08:00
* Draft ContextMenu requirement set

* Fix heading

* Update requirement set name and platform availability

* Update article title

* Update ms.date and add version numbers
diff --git a/docs/manifest/control-button.md b/docs/manifest/control-button.md
@@ -50,7 +50,7 @@ For more information, see [Version overrides in the add-in only manifest](/offic
 
 ## Examples
 
-In the following example, the button executes a function. It's also configured to be disabled when the add-in launches. It can be programmatically enabled. For more information, see [Enable and Disable Add-in Commands](/office/dev/add-ins/design/disable-add-in-commands).
+In the following example, the button executes a function. It's also configured to be disabled when the add-in launches. It can be programmatically enabled. For more information, see [Change the availability of add-in commands](/office/dev/add-ins/design/disable-add-in-commands).
 
 ```xml
 <Control xsi:type="Button" id="Contoso.msgReadFunctionButton">
diff --git a/docs/manifest/enabled.md b/docs/manifest/enabled.md
@@ -1,14 +1,17 @@
 ---
 title: Enabled element in the manifest file
 description: Learn how to specify that an Add-in Command is disabled when the add-in launches.
-ms.date: 03/12/2022
+ms.date: 03/11/2025
 ms.localizationpriority: medium
 ---
 
 # Enabled element
 
 Specifies whether a [Button control](control-button.md) or [Menu control](control-menu.md) is enabled when the add-in launches. The **\<Enabled\>** element is a child element of [Control](control.md). If it is omitted, the default is `true`.
 
+> [!NOTE]
+> The **\<Enabled\>** element is only supported for controls on the ribbon. It isn't supported for controls added to the Office context menu.
+
 **Add-in type:** Task pane
 
 **Valid only in these VersionOverrides schemas**:
@@ -21,9 +24,9 @@ For more information, see [Version overrides in the add-in only manifest](/offic
 
 - [RibbonApi 1.0](../requirement-sets/common/ribbon-api-requirement-sets.md)
 
-This element is only valid in Excel, PowerPoint, and Word; that is, when the `Name` attribute of the [Host](host.md) element is "Workbook", "Presentation", or "Document".
+This element is only valid in **Excel**, **PowerPoint**, and **Word**; that is, when the `Name` attribute of the [Host](host.md) element is "Workbook", "Presentation", or "Document".
 
-The parent control can also be programmatically enabled and disabled. For more information, see [Enable and Disable Add-in Commands](/office/dev/add-ins/design/disable-add-in-commands).
+The parent control can also be programmatically enabled and disabled. For more information, see [Change the availability of add-in commands](/office/dev/add-ins/design/disable-add-in-commands).
 
 ## Example
 
diff --git a/docs/manifest/extensionpoint.md b/docs/manifest/extensionpoint.md
@@ -1,7 +1,7 @@
 ---
 title: ExtensionPoint element in the manifest file
 description: Defines where an add-in exposes functionality in the Office UI.
-ms.date: 02/27/2025
+ms.date: 03/11/2025
 ms.localizationpriority: medium
 ---
 
@@ -88,7 +88,7 @@ A context menu is a shortcut menu that appears when you right-click (or select a
 
 #### Example
 
-The following customizes the context menu opened on the selected text in a supported Office application. Note that the child control must be of type **Button**.
+The following customizes the context menu opened on the selected text in a supported Office application. The context menu control used is of type **Button**.
 
 ```xml
 <ExtensionPoint xsi:type="ContextMenu">
diff --git a/docs/manifest/officemenu.md b/docs/manifest/officemenu.md
@@ -1,7 +1,7 @@
 ---
 title: OfficeMenu element in the manifest file
 description: The OfficeMenu element defines a collection of controls to be added to the Office context menu.
-ms.date: 08/13/2024
+ms.date: 03/11/2025
 ms.localizationpriority: medium
 ---
 
@@ -34,15 +34,15 @@ Although its official data type is string, this attribute effectively functions
 - `ContextMenuText` - Displays the item on the context menu when text is selected and the user opens that menu (e.g., right-clicks) on the selected text. Applies to Word, Excel, PowerPoint, and OneNote.
 - `ContextMenuCell` - Displays the item on the context menu when the user opens that menu (e.g., right-clicks) on a cell on the spreadsheet. Applies to Excel.
 
-
 ## Child elements
 
-|  Element |  Required  |  Description  |
+| Element | Required | Description |
 |:-----|:-----:|:-----|
-|  [Control of type Button](control-button.md)    | Yes |  A single **Button** control object.  |
+| [Control of type Button](control-button.md) | Yes | A single **Button** control object. |
+| [Control of type Menu](control-menu.md) | Yes | A single **Menu** control object. |
 
 > [!NOTE]
-> There can be only one child control and it must be type **Button**.
+> There can be only one child control.
 
 ## Example
 
diff --git a/docs/requirement-sets/common/context-menu-api-requirement-sets.md b/docs/requirement-sets/common/context-menu-api-requirement-sets.md
@@ -0,0 +1,37 @@
+---
+title: Context Menu API requirement sets
+description: Learn more about the Context Menu API requirement sets and the platforms it supports.
+ms.date: 03/11/2025
+ms.topic: overview
+ms.localizationpriority: medium
+---
+
+# Context Menu API requirement sets
+
+Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office application supports APIs that an add-in needs. For more information, see [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets).
+
+Use the Context Menu API requirement set to configure the availability of custom items on a context menu in Office.
+
+`ContextMenuApi 1.1` is supported in **Excel**, **PowerPoint**, and **Word**. The following table lists the minimum builds or versions for these applications, where applicable.
+
+| Requirement set | Office on the web | Office on Windows<br>(Microsoft 365 subscription) | Office on Windows<br>(retail perpetual) | Office on Windows<br>(volume-licensed perpetual) | Office on Mac | Office on iOS | Outlook on Android |
+|:-----|:-----|:-----|:-----|:-----|:-----|:-----|:-----|
+| ContextMenuApi 1.1 | Supported | Version 2502 (Build 18526.20144) | Version 2502 (Build 18526.20144) | Not supported | Version 16.94 (25020927) | Not supported | Not supported |
+
+To find out more about versions and build numbers, see:
+
+[!INCLUDE [Links to get Office versions and how to find Office client version](../../includes/links-get-office-versions-builds.md)]
+
+## Office Common API requirement sets
+
+For information about Common API requirement sets, see [Office Common API requirement sets](office-add-in-requirement-sets.md).
+
+## ContextMenuApi 1.1
+
+To learn how to programmatically configure the availability of custom items on a context menu, see [Change the availability of add-in commands](/office/dev/add-ins/design/disable-add-in-commands). For details about the API, see [Office.ContextMenu](/javascript/api/office/office.contextmenu).
+
+## See also
+
+- [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets)
+- [Specify Office applications and API requirements](/office/dev/add-ins/develop/specify-office-hosts-and-api-requirements)
+- [Office Add-ins manifest](/office/dev/add-ins/develop/add-in-manifests)
diff --git a/docs/requirement-sets/common/office-add-in-requirement-sets.md b/docs/requirement-sets/common/office-add-in-requirement-sets.md
@@ -1,7 +1,7 @@
 ---
 title: Office Common API requirement sets
 description: Learn more about the Office Common API requirement sets.
-ms.date: 10/17/2024
+ms.date: 03/11/2025
 ms.topic: overview
 ms.localizationpriority: medium
 ---
@@ -56,6 +56,14 @@ See [Add-in command requirement sets](add-in-commands-requirement-sets.md).
 
 ---
 
+### ContextMenuApi
+
+| Minimum Office application support | Methods in set |
+|:-----|:-----|
+| See [Context Menu API requirement sets](context-menu-api-requirement-sets.md). | <ul><li>Office.contextMenu.requestUpdate</li></ul> |
+
+---
+
 ### CustomXmlParts
 
 | Minimum Office application support | Methods in set |
diff --git a/docs/requirement-sets/common/ribbon-api-requirement-sets.md b/docs/requirement-sets/common/ribbon-api-requirement-sets.md
@@ -31,7 +31,7 @@ For information about Common API requirement sets, see [Office Common API requir
 
 ## Ribbon API 1.1
 
-The Ribbon API 1.1 includes support for enabling and disabling Add-in Commands. To learn the patterns for this functionality, see [Enable and Disable Add-in Commands](/office/dev/add-ins/design/disable-add-in-commands). For details about the API, see the [Office.ribbon](/javascript/api/office/office.ribbon) reference topic.
+The Ribbon API 1.1 includes support for enabling and disabling Add-in Commands. To learn the patterns for this functionality, see [Change the availability of add-in commands](/office/dev/add-ins/design/disable-add-in-commands). For details about the API, see the [Office.ribbon](/javascript/api/office/office.ribbon) reference topic.
 
 ## Ribbon API 1.2
 
diff --git a/docs/requirement-sets/requirement-sets.md b/docs/requirement-sets/requirement-sets.md
