Runtimes element

Specifies the runtime of your add-in. Child of the Host element.

Note

When running in Office on Windows, an add-in that has a <Runtimes> element in its manifest does not necessarily run in the same webview control as it otherwise would. For more information about how the versions of Windows and Office determine what webview control is normally used, see Browsers used by Office Add-ins. If the conditions described there for using Microsoft Edge with WebView2 (Chromium-based) are met, then the add-in uses that browser whether or not it has a <Runtimes> element. However, when those conditions are not met, an add-in with a <Runtimes> element always uses Internet Explorer 11 regardless of the Windows or Microsoft 365 version.

Add-in type: Task pane, Mail

Valid only in these VersionOverrides schemas:

• Task pane 1.0
• Mail 1.1

For more information, see Version overrides in the manifest.

Associated with these requirement sets:

• SharedRuntime 1.1 (Only when used in a task pane add-in.)
• Mailbox 1.10 and later (When used in an Outlook add-in that implements event-based activation.)
• Mailbox preview (When used in an Outlook add-in that implements the integrated spam reporting (preview) feature.)

Important

For the shared JavaScript runtime, this element enables the ribbon, task pane, and other supported components to use the same runtime. However, the SharedRuntime requirement set is only available in some Office applications. For more information, see Shared runtime requirement sets.

Outlook

• For event-based activation, this element enables your add-in to run on composing a new item, for example. For supported clients and other information, see Configure your Outlook add-in for event-based activation.
• For integrated spam reporting (preview), this element enables your add-in to process unsolicited messages. To learn more about how to implement the integrated spam reporting feature in your add-in, see Implement an integrated spam-reporting add-in (preview).

Note that the event-based activation and integrated spam reporting features must use the same runtime. Multiple runtimes aren't currently supported in Outlook.

Syntax

<Runtimes>
    <Runtime resid="ContosoAddin.Url" lifetime="long" />
</Runtimes>

Contained in

Host

Child elements

Element	Required	Description
Runtime	Yes	The runtime for your add-in. Important: At present, you can only define one <Runtime> element.

See also

• Runtime
• Runtimes in Office Add-ins
• Configure your Office Add-in to use a shared JavaScript runtime
• Configure your Outlook add-in for event-based activation
• Implement an integrated spam-reporting add-in (preview)