Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 Add-ins run across multiple versions of Office. The following table lists the Dialog API requirement sets, the supported Office client applications, and the minimum builds or versions for those applications where applicable.
| Requirement set | Office on the web | Office on Windows (Microsoft 365 subscription) |
Office on Windows1 (retail perpetual) |
Office on Windows(volume-licensed perpetual/LTSC) | Office on Mac | Office on iPad | Office Online Server |
|---|---|---|---|---|---|---|---|
| DialogApi 1.2 | Supported |
|
Version 2005 (Build 12827.20268) | Office 2021: Version 2005 (Build 12827.20268) | Version 16.37 (20051002) | Version 16.37 | Not supported |
| DialogApi 1.1 | Supported |
|
Version 1602 (Build 6741.0000) | Office 2021 | Version 15.20 | Version 1.22 | Version 1608 (Build 7601.6800) |
Outlook support
In Outlook, dialog features and their APIs were introduced in the following Mailbox requirement sets.
| Feature | API | Mailbox requirement set |
|---|---|---|
| Display a dialog | Office.context.ui.displayDialogAsync | 1.4 |
| Deliver a message from the dialog to the its parent page | Office.context.ui.messageParent | 1.4 |
| Close a dialog | Office.context.ui.closeContainer | 1.5 |
| Deliver a message from the host page to a dialog | Office.dialog.messageChild | 1.9* |
Note
* Although classic Outlook on Mac doesn't support Mailbox requirement set 1.9, it does support the DialogApi 1.2 requirement set.
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.
Dialog API 1.1 and 1.2
The Dialog API 1.1 is the first version of the API (see Office.UI). Requirement set 1.2 adds support for sending data from the parent page to the dialog box with the Office.dialog.messageChild method. For details about these APIs, see the Dialog API reference topic.
See also
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Office Add-ins