Add-in commands 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.
Add-in commands are UI elements that extend the Office UI and start actions in your add-in. You can use add-in commands to add a button on the ribbon or an item to a context menu. For more information, see Add-in commands for Excel, Word, and PowerPoint and Add-in commands for Outlook.
Note
Outlook add-ins support add-in commands, but the APIs and manifest elements that enable add-in commands in Outlook are in the Mailbox 1.3 requirement set. The AddinCommands requirement sets are not applicable to Outlook.
The initial release of add-in commands doesn't have a corresponding requirement set (that is, there isn't an AddinCommands 1.0 requirement set). The following table lists the Office client applications that support the initial release version, and the build versions or number for those applications.
| Release | Office 2013 on Windows (one-time purchase) |
Office 2016 on Windows (one-time purchase) |
Office 2019 on Windows (one-time purchase) |
Office 2021 on Windows (one-time purchase) |
Office on Windows (subscription) |
Office on iPad (subscription) |
Office on Mac (both subscription and one-time purchase Office on Mac 2019 and later) |
Office on the web |
|---|---|---|---|---|---|---|---|---|
| Add-in commands (initial release, no requirement set) | N/A | N/A | Version 1809 (Build 10827.20150) or later | 16.0.14326.20454 or later | Version 1603 (Build 6769.0000) or later | N/A | 15.33 or later | January 2016 |
The add-in commands 1.1 requirement set introduces the ability to autoopen a task pane with documents.
The add-in commands 1.3 requirement set introduces manifest markup that enables an add-in to customize the placement of a custom tab on the Office ribbon and to insert built-in Office ribbon controls into custom control groups.
The following table lists the add-in commands requirement sets, the Office client applications that support that requirement set, and the build or version numbers for the Office application.
| Requirement set | Office 2013 on Windows (one-time purchase) |
Office 2016 on Windows (one-time purchase) |
Office 2019 on Windows (one-time purchase) |
Office 2021 on Windows (one-time purchase) |
Office on Windows (subscription) |
Office on iPad (subscription) |
Office on Mac (both subscription and one-time purchase Office on Mac 2019 and later) |
Office on the web |
|---|---|---|---|---|---|---|---|---|
| AddinCommands 1.3 | N/A | N/A | N/A | N/A | Version 2204 (Build 14827.10000) or later | N/A | 16.57.105.0 or later | November 2020 |
| AddinCommands 1.1 | N/A | N/A | Version 1809 (Build 10827.20150) or later† | 16.0.14326.20454 or later† | Version 1705 (Build 8121.1000) or later† | N/A | 15.34 or later†* | May 2017 |
* The Office.context.requirements.isSetSupported method will erroneously return false for versions 16.9 – 16.14 (inclusive), but the requirement set is supported on these versions.
† OneNote is supported only in Office on the web.
Office versions and build numbers
To find out more about versions, build numbers, and Office Online Server, see:
- Version and build numbers of update channel releases for Microsoft 365 clients
- What version of Office am I using?
Office Common API requirement sets
For information about Common API requirement sets, see Office Common API requirement sets.
See also
Feedback
Submit and view feedback for