diff --git a/docs/requirement-sets/common/ribbon-api-requirement-sets.md b/docs/requirement-sets/common/ribbon-api-requirement-sets.md index 00dc16f6f1..33bab3e84f 100644 --- a/docs/requirement-sets/common/ribbon-api-requirement-sets.md +++ b/docs/requirement-sets/common/ribbon-api-requirement-sets.md @@ -1,7 +1,7 @@ --- title: Ribbon API requirement sets description: Specifies which Office platforms and builds support the dynamic ribbon APIs. -ms.date: 10/17/2025 +ms.date: 07/30/2026 ms.topic: overview ms.localizationpriority: medium --- @@ -10,16 +10,24 @@ ms.localizationpriority: medium 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). -The Ribbon API set supports programmatic control of when custom add-in commands (that is, custom ribbon buttons and menu items) are enabled and disabled and when contextual tabs appear on the ribbon. +The Ribbon API requirement sets let add-ins programmatically control custom ribbon elements. Add-ins can: + +- Enable or disable add-in commands. +- Show contextual tabs on the ribbon. +- Show or hide commands on a custom tab. ## Support -`RibbonApi 1.1` is available with **Excel**, **PowerPoint**, and **Word**. `RibbonApi 1.2` is only available with **Excel**. Both are only for use with **task pane add-ins**. The following table lists the Ribbon API requirement sets, the supported platforms, and the **minimum** builds or versions where applicable. +The following table lists the Ribbon API requirement sets, supported applications and platforms, and the **minimum** builds or versions where applicable. + +| Requirement set | Applications | Office on the web | Office on Windows
(Microsoft 365 subscription) | Office on Windows
(retail perpetual) | Office on Windows
(volume-licensed perpetual/[LTSC](/office/dev/add-ins/resources/resources-glossary#long-term-service-channel-ltsc)) | Office on Mac | Office on iOS | Outlook on Android | +|:-----|:-----|:-----|:-----|:-----|:-----|:-----|:-----|:-----| +| RibbonApi 1.3 | | Supported | Version 2606 (Build 20112.15190) | Version 2606 (Build 20112.15190) | Not supported | Version 16.109.1 (260512.115) | Not supported | Not supported | +| RibbonApi 1.2 | | Supported | Version 2102 (Build 13801.20294) | Version 2102 (Build 13801.20294) | Office 2021: Version 2108 (Build 14326.20454) | Version 16.53 (21080600) | Not supported | Not supported | +| RibbonApi 1.1 | | Supported | Version 2002 (12527.20880) | Version 2006 (Build 13001.20266) | Office 2021: Version 2108 (Build 14326.20454) | Version 16.38 (20061401) | Not supported | Not supported | -| Requirement set | Office on the web | Office on Windows
(Microsoft 365 subscription) | Office on Windows
(retail perpetual) | Office on Windows
(volume-licensed perpetual/[LTSC](/office/dev/add-ins/resources/resources-glossary#long-term-service-channel-ltsc)) | Office on Mac | Office on iOS | Outlook on Android | -|:-----|:-----|:-----|:-----|:-----|:-----|:-----|:-----| -| RibbonApi 1.2 | Supported | Version 2102 (Build 13801.20294) | Version 2102 (Build 13801.20294) | Office 2021: Version 2108 (Build 14326.20454) | Version 16.53 (21080600) | Not supported | Not supported | -| RibbonApi 1.1 | Supported | Version 2002 (12527.20880) | Version 2006 (Build 13001.20266) | Office 2021: Version 2108 (Build 14326.20454) | Version 16.38 (20061401) | Not supported | Not supported | +> [!NOTE] +> `RibbonApi 1.1` and `RibbonApi 1.2` are only for use with task pane add-ins. To find out more about versions and build numbers, see: @@ -31,15 +39,19 @@ 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 [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.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 -The Ribbon API 1.2 adds support for contextual tabs. For more information, see [Create custom contextual tabs in Office Add-ins](/office/dev/add-ins/design/contextual-tabs). +Ribbon API 1.2 adds support for contextual tabs. For more information, see [Create custom contextual tabs in Office Add-ins](/office/dev/add-ins/design/contextual-tabs). > [!NOTE] > The **RibbonApi 1.2** requirement set isn't yet supported in the manifest, so you shouldn't specify it in the manifest's **\** section. +## Ribbon API 1.3 + +Ribbon API 1.3 adds support to dynamically show or hide add-in commands on a custom tab. + ## See also - [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets) diff --git a/docs/requirement-sets/requirement-sets.md b/docs/requirement-sets/requirement-sets.md index ba67a05eb9..94f9633d6f 100644 --- a/docs/requirement-sets/requirement-sets.md +++ b/docs/requirement-sets/requirement-sets.md @@ -1,7 +1,7 @@ --- title: Office client application and platform availability for Office Add-ins description: Supported requirement sets for Excel, OneNote, Outlook, PowerPoint, Project, and Word. -ms.date: 07/14/2026 +ms.date: 07/30/2026 ms.topic: overview ms.localizationpriority: high --- @@ -22,12 +22,12 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| -|Office on the web|||| -|Office on Windows (Microsoft 365 subscription)|||| -|Office on Windows
(retail perpetual Office 2021 and later)|||| +|Office on the web|||| +|Office on Windows (Microsoft 365 subscription)|||| +|Office on Windows
(retail perpetual Office 2021 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual/LTSC)|||| |Office 2021 on Windows
(volume-licensed perpetual/LTSC)|||| -|Office on Mac|||| +|Office on Mac|||| |Office on iPad
(Microsoft 365 subscription)|||| ** Added with post-release updates.* @@ -85,12 +85,12 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| -|Office on the web|||| -|Office on Windows
(Microsoft 365 subscription)|||| -|Office on Windows
(retail perpetual Office 2021 and later)|||| +|Office on the web|||| +|Office on Windows
(Microsoft 365 subscription)|||| +|Office on Windows
(retail perpetual Office 2021 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual/LTSC)|||| |Office 2021 on Windows
(volume-licensed perpetual/LTSC)|||| -|Office on Mac|||| +|Office on Mac|||| |Office on iPad
(Microsoft 365 subscription)|||| ** Added with post-release updates.* @@ -99,12 +99,12 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| -|Office on the web|||| -|Office on Windows
(Microsoft 365 subscription)|||| -|Office on Windows
(retail perpetual Office 2021 and later)|||| +|Office on the web|||| +|Office on Windows
(Microsoft 365 subscription)|||| +|Office on Windows
(retail perpetual Office 2021 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual/LTSC)|||| |Office 2021 on Windows
(volume-licensed perpetual/LTSC)|||| -|Office on Mac|||| +|Office on Mac|||| |Office on iPad|||| ** Added with post-release updates.*