Runtime element

Article
07/21/2023

Configures your add-in to use a shared JavaScript runtime so that various components all run in the same runtime. Child of the Runtimes element.

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

Runtimes

Child elements

Element	Required	Description
Override	No	Outlook: Specifies the URL location of the JavaScript file that Outlook on Windows requires for LaunchEvent extension point and ReportPhishingCommandSurface extension point (preview) handlers. Important: At present, you can only define one <Override> element and it must be of type `javascript`.

Attributes

Attribute	Required	Description
resid	Yes	Specifies the URL location of the HTML page for your add-in. The `resid` can be no more than 32 characters and must match an `id` attribute of a `Url` element in the `Resources` element.
lifetime	No	The default value for `lifetime` is `short` and doesn't need to be specified. Outlook event-based activation and spam-reporting add-ins use only the `short` value. If you want to use a shared runtime in an Excel add-in, explicitly set the value to `long`.

lifetime attribute

Optional. Represents the length of time the add-in is allowed to run.

Available values

short: Default. Used only for Outlook event-based activation and spam-reporting add-ins. After the add-in is activated, it will run for a maximum amount of time as specified by the platform. Currently, that's around 5 minutes. This is the only value supported by Outlook.

long: Used only when configuring a shared JavaScript runtime. The add-in can start on document open and run indefinitely. For example, task pane code will continue running even when the user closes the task pane. This is the only value supported by the shared runtime.