VersionOverrides

The VersionOverrides element was specifically designed to accommodate future functionality.
This replaces DefaultSettings and FormSettings

The elements defined here may be overrides to previously defined elements or new elements.

<VersionOverrides/> 
   <Description> 
   <Hosts> 
   <Requirements> 
   <Resources> 
   <WebApplicationInfo> 
</VersionOverrides> 

Description

Optional. see page

Hosts

Optional. see page

Requirements

Optional. see page

Resources

Required. see page

WebApplicationInfo

Optional. see page

Supporting Multiple Versions

The manifest can implement multiple versions of the VersionOverrides element.
Each one supporting a different version of the VersionOverrides schema.
This allows new features in a newer schema to be supported
While at the same time continuing to support older clients.
This can be achieved by adding the VersionOverrides element for the newer schema as a child of the older schema
The child will not inherit any values from the parent

<OfficeApps> 
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" 
    xsi:type="VersionOverridesV1_0"> 
    <Description> 
    <Hosts> 
    <Requirements> 
    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" 
      xsi:type="VersionOverridesV1_1"> 

EquivalentAddins

    <EquivalentAddin> 
      <FileName>contosofunctions.xll</FileName> 
      <Type>XLL</Type> 
    </EquivalentAddin> 

ExtendedOverrides

  <ExtendedOverrides Url="http://bettersolutions.com/addinmetadata/${token.locale}/extended-manifest-overrides.json"> 
    <Tokens> 
      <Token Name="locale" DefaultValue="en-us" xsi:type="LocaleToken"> 
        <Override Locale="es-*" Value="es-es" /> 
      </Token> 
    <Tokens> 
  </ExtendedOverrides> 

ExtendedPermissions

    <ExtendedPermissions> 
      <ExtendedPermission>AppendOnSend</ExtendedPermission> 
    </ExtendedPermissions>