Resources element

Contains icons, strings, and URLs for the VersionOverrides node. A manifest element specifies a resource by using the id of the resource. This helps to keep the size of the manifest manageable, especially when resources have versions for different locales. An id must be unique within the manifest and can have a maximum of 32 characters.

Each resource can have one or more Override child elements to define a different resource for a specific locale.

Child elements

Element Type Description
Images image Provides the HTTPS URL to an image for an icon.
Urls url Provides an HTTPS URL location. A URL can have a maximum of 2048 characters.
ShortStrings string The text for Label and Title elements. Each String contains a maximum of 125 characters.
LongStrings string The text for Description attributes. Each String contains a maximum of 250 characters.

Note You must use Secure Sockets Layer (SSL) for all URLs in the Image and Url elements.

Images

Each icon must have three Images elements, one for each of the three mandatory sizes:

  • 16x16
  • 32x32
  • 80x80

The following additional sizes are also supported, but not required:

  • 20x20
  • 24x24
  • 40x40
  • 48x48
  • 64x64

Important: Outlook requires the ability to cache image resources for performance purposes. For this reason, the server hosting an image resource must not add any CACHE-CONTROL directives to the response header. This will result in Outlook automatically substituting a generic or default image.

Resources examples

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_32x32" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp32-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_80x80" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp80-icon_default.png" />
        </bt:Image>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="residDesktopFuncUrl" DefaultValue="https://www.contoso.com/Pages/Home.aspx">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Pages/Home.aspx" />
        </bt:Url>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="residLabel" DefaultValue="GetData">
          <bt:Override Locale="ja-jp" Value="JA-JP-GetData" />
        </bt:String>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="residToolTip" DefaultValue="Get data for your document.">
          <bt:Override Locale="ja-jp" Value="JA-JP - Get data for your document." />
        </bt:String>
      </bt:LongStrings>
    </Resources>
<Resources>
  <bt:Images>
    <!-- Blue icon -->
    <bt:Image id="blue-icon-16" DefaultValue="YOUR_WEB_SERVER/blue-16.png"/>
    <bt:Image id="blue-icon-32" DefaultValue="YOUR_WEB_SERVER//blue-32.png"/>
    <bt:Image id="blue-icon-80" DefaultValue="YOUR_WEB_SERVER/blue-80.png"/>
  </bt:Images>
  <bt:Urls>
    <bt:Url id="functionFile" DefaultValue="YOUR_WEB_SERVER/FunctionFile/Functions.html"/>
    <!-- other URLs -->
  </bt:Urls>
  <bt:ShortStrings>
    <bt:String id="groupLabel" DefaultValue="Add-in Demo">
      <bt:Override Locale="ar-sa" Value="<Localized text>" />
    </bt:String>
    <!-- Other short strings -->
  </bt:ShortStrings>
  <bt:LongStrings>
    <bt:String id="funcReadSuperTipDescription" DefaultValue="Gets the subject of the message or appointment.">
      <bt:Override Locale="ar-sa" Value="<Localized text>." />
    </bt:String>
    <!-- Other long strings -->
  </bt:LongStrings>
</Resources>
v>
fault Office UI tabs. The following table lists the values that you can use for the id attribute of the OfficeTab element. The tab values are case sensitive.

For recommendations for where to place your commands in the ribbon, see Best practices for developing Office Add-ins.

Office host application Tab values
Excel TabHome+
TabInsert+
TabPageLayoutExcel

TabFormulas
TabData+
TabReview+
TabView+
TabDeveloper
TabAddIns

TabPrintPreview
TabBackgroundRemoval
Word TabHome+
TabInsert+
TabWordDesign

TabPageLayoutWord+
TabReferences
TabMailings
TabReviewWord
TabView+
TabDeveloper

TabAddIns
TabBlogPost
TabBlogInsert

TabPrintPreview
TabOutlining
TabConflicts
TabBackgroundRemoval
TabBroadcastPresentation
PowerPoint TabHome+
TabInsert+
TabDesign
+
TabTransitions+
TabAnimations+
TabSlideShow
TabReview
TabView+
TabDeveloper

TabAddIns
TabPrintPreview
TabMerge

TabGrayscale
TabBlackAndWhite
TabBroadcastPresentation
TabSlideMaster
TabHandoutMaster
TabNotesMaster

TabBackgroundRemoval
TabSlideMasterHome

+Tab exists in both Office for Windows Desktop and Office Online.