ExtendedPermission element

Defines an extended permission the add-in needs to access the associated API or feature. The ExtendedPermission element is a child element of ExtendedPermissions.

Important

Support for this element was introduced in requirement set 1.9. See clients and platforms that support this requirement set.

Add-in type: Mail

Valid only in these VersionOverrides schemas:

  • Mail 1.1

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

Associated with these requirement sets:

Available extended permissions

The following are the available values.

Available value Description Hosts
AppendOnSend Declares that the add-in uses the Office.Body.prependOnSendAsync or Office.Body.appendOnSendAsync API.

To learn more, see Prepend or append content to a message or appointment body on send.
Outlook

ExtendedPermission example

The following is an example of the ExtendedPermission element.

...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    ...
    <Hosts>
      <Host xsi:type="MailHost">
        <DesktopFormFactor>
          <SupportsSharedFolders>true</SupportsSharedFolders>
          <FunctionFile resid="residDesktopFuncUrl" />
          <ExtensionPoint xsi:type="MessageReadCommandSurface">
            <!-- Configure your selected extension point. -->
          </ExtensionPoint>

          <!-- You can define more than one ExtensionPoint element as needed. -->

        </DesktopFormFactor>
      </Host>
    </Hosts>
    ...
    <!-- Configure the prepend-on-send or append-on-send feature using the AppendOnSend value. -->
    <ExtendedPermissions>
      <ExtendedPermission>AppendOnSend</ExtendedPermission>
    </ExtendedPermissions>
  </VersionOverrides>
</VersionOverrides>
...

Contained in