Dialog 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 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 Windows1
(volume-licensed perpetual)
Office on Mac Office on iPad Office Online Server
DialogApi 1.2 Supported See support
section
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) Version 1602 (Build 6741.0000) Office 20162 Version 15.20 Version 1.22 Version 1608 (Build 7601.6800)

Note

1Users of perpetual versions of Office may not have accepted all patches and updates. If so, the DLL that Office uses to report its version in the UI may be greater than the versions listed here even if the updated DLLs needed to support DialogApi haven't been installed on the user's computer. To ensure that the needed patch is installed, the user must go to the Office 2016 update list, search for osfclient-x-none, and install the listed patch.

2 DialogApi 1.1 isn't supported in Outlook 2016 (volume-licensed perpetual).

Office on Windows (Microsoft 365 subscription) support

The DialogApi 1.2 requirement set is supported in the Consumer Channel from Version 2005 (Build 12827.20268). That requirement set is also supported in the Semi-Annual Channel and Monthly Enterprise Channel builds available since June 9, 2020. The minimum supported builds for each channel are as follows:

Channel Minimum version Minimum build
Current Channel 2005 12827.20160
Monthly Enterprise Channel 2004 12730.20430
Semi-Annual Enterprise Channel 2002 12527.20720

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:

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