VersionOverrides 1.0 element in the manifest file for a task pane add-in

This element contains information for features that aren't supported in the base manifest.

Note

This article assumes that you're familiar with the overview of the VersionOverrides element, which contains important information about the element's attributes and variations.

Add-in type: Task pane

Valid only in these VersionOverrides schemas:

  • Taskpane 1.0

For more information, see Version overrides in the add-in only manifest.

Associated with these requirement sets:

  • AddinCommands 1.1 (Required for Excel, PowerPoint, and Word)
  • Some child elements may be associated with additional requirement sets.

Child elements

The following table applies only to version 1.0 of <VersionOverrides> elements and only to task pane add-ins.

Note

In iOS, only <WebApplicationInfo> is supported. All other child elements of <VersionOverrides> are ignored.

Element Required Description
Description No Describes the add-in.
Requirements No Specifies the minimum requirement sets that must be supported in order for the markup in the parent <VersionOverrides> to take effect. This should always be more restrictive than the <Requirements> element in the base portion of the manifest.
Hosts Yes Specifies a collection of Office applications. The child Hosts element overrides the Hosts element in the parent portion of the manifest.
Resources Yes Defines a collection of resources (strings, URLs, and images) that other manifest elements reference.
EquivalentAddins No Specifies the native (COM/XLL) add-ins that are equivalent to the web add-in. The web add-in isn't activated if an equivalent native add-in is installed.
<VersionOverrides> No Not currently usable in VersionOverrides 1.0 for taskpane add-ins.
WebApplicationInfo No Specifies details about the add-in's registration with secure token issuers, such as Azure Active Directory V2.0.

Description

Describes the add-in. This overrides the <Description> element in any parent portion of the manifest. The text of the description is contained in a child element of the LongString element contained in the Resources element. The resid attribute of the <Description> element can be no more than 32 characters and must match the value of the id attribute of a child element of the <ShortString> element contained in the Resources element.

Add-in type: Task pane, Mail

Valid only in these VersionOverrides schemas:

  • Task pane 1.0
  • Mail 1.0
  • Mail 1.1

For more information, see Version overrides in the add-in only manifest.

Associated with these requirement sets:

  • AddinCommands 1.1 when the parent <VersionOverrides> is type Taskpane 1.0.
  • Mailbox 1.3 when the parent <VersionOverrides> is type Mail 1.0.
  • Mailbox 1.5 when the parent <VersionOverrides> is type Mail 1.1.

Example

The following is a simple example. For more complex examples, see the manifests for the sample add-ins in Office Add-in code samples.

<OfficeApp ... xsi:type="Taskpane">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="Workbook">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>