Office versions and requirement sets
- Office runs across multiple platforms, including Windows, in a browser, Mac, and iPad.
- Examples of Office applications are Office Products: Excel, Word, PowerPoint, Outlook, OneNote, and so forth.
- A requirement set is a named group of API members e.g.,
WordApi 1.3, and so on.
How to check your Office version
To identify the Office version that you're using, from within an Office application, select the File menu, and then choose Account. The version of Office will appear in the Product Information section. For example, the following screenshot indicates Office Version 1802 (Build 9026.1000).
Office requirement sets availability
Office Add-ins can use API requirement sets to determine whether the Office application supports the API members that it need to use. Requirement set support varies by Office application and the Office application version (see previous section).
Some Office applications have their own API requirement sets. For example, the first requirement set for the Excel API was
ExcelApi 1.1 and the first requirement set for the Word API was
WordApi 1.1. Since then, multiple new ExcelApi requirement sets and WordApi requirement sets have been added to provide additional API functionality.
In addition, other functionality such as add-in commands (ribbon extensibility) and the ability to launch dialog boxes (Dialog API) were added to the Common API. Add-in commands and Dialog API requirement sets are examples of API sets that the various Office applications share in common.
An add-in can only use APIs in requirement sets that are supported by the version of Office application where the add-in is running. To know exactly which requirement sets are available for a specific Office application version, refer to the following application-specific requirement set articles.
- Understanding Outlook API requirement sets (Mailbox)
Some requirement sets contain APIs that can be used by any Office application. For information about these requirement sets, refer to the following articles.
- Office common requirement sets
- Add-in commands requirement sets
- Dialog API requirement sets
- Identity API requirement sets
The version number of a requirement set, such as the "1.1" in
ExcelApi 1.1, is relative to the Office application. The version number of a given requirement set (e.g.,
ExcelApi 1.1) does not correspond to the version number of Office.js or to requirement sets for other Office applications (e.g., Word, Outlook, etc.). Requirement sets for the different Office applications are released at different rates. For example,
ExcelApi 1.5 was released before the
WordApi 1.3 requirement set.
ExcelApi 1.3 and
WordApi 1.3, there is no
Specify Office applications and requirement sets
There are various ways to specify which Office applications and requirement sets are required by an add-in. For detailed information, see Specify Office applications and API requirements