ExtendedOverrides element

Article
02/13/2025

Specifies the full URLs for JSON-formatted files that extend the manifest.

Note

The keyboard shortcut feature requires an extended override. To learn more, see Add custom keyboard shortcuts to your Office Add-ins.

Add-in type: Task pane

Syntax

<ExtendedOverrides Url="string" [ResourcesUrl="string"] ></ExtendedOverrides>

Contained in

OfficeApp

Can contain

The <ExtendedOverrides> element can contain the following child element depending on the add-in type.

Element	Content	Mail	TaskPane
Tokens	No	No	Yes

Attributes

Attribute	Description
Url (required)	The full URL of the extended overrides JSON file. In the future, this value could be a URL template that uses tokens defined by the Tokens element. See Examples.
ResourcesUrl (optional)	The full URL of a file that provides supplemental resources, such as localized strings, for the file specified in the `Url` attribute. This could be a URL template that uses tokens defined by the Tokens element.

Examples

<OfficeApp ...>
  <!-- other elements omitted -->
  <ExtendedOverrides Url="http://contoso.com/addinmetadata/extended-manifest-overrides.json"
                     ResourceUrl="https://contoso.com/addin/my-resources.json">
  </ExtendedOverrides>
</OfficeApp>

In the future, this value could be a URL template that uses tokens defined by the Tokens element. The following is an example.

<OfficeApp ...>
  <!-- other elements omitted -->
  <ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.locale}/extended-manifest-overrides.json">
    <Tokens>
      <Token Name="locale" DefaultValue="en-us" xsi:type="LocaleToken">
        <Override Locale="es-*" Value="es-es" />
        <Override Locale="es-mx" Value="es-mx" />
        <Override Locale="fr-*" Value="fr-fr" />
        <Override Locale="ja-jp" Value="ja-jp" />
      </Token>
    <Tokens>
  </ExtendedOverrides>
</OfficeApp>

Share via