ByProgID element (Document Icons)

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines icons for documents according to their programmatic identifiers.


Elements and attributes

The following sections describe attributes, child elements, and parent elements.



Child elements

Parent elements


  • Minimum: 0
  • Maximum: Unbounded


This element is used in the DocIcon.xml file to drive mapping between ProgIDs and their corresponding document library icons.


A ProgId is a registry entry that associates the program identifier (ProgID) of a COM object with its class identifier (CLSID). For example, the registry key HKLM\Software\Classes\Word.Document has a subkey named CLSID with a value of {F4754C9B-64F5-4B40-8AF4-679732AC0607}. In this case, the key name Word.Document is a ProgId, a shorthand way of saying {F4754C9B-64F5-4B40-8AF4-679732AC0607}. For more information, see <ProgId> Key (COM).

For example, an HTML document that contains <META Name="ProgId" Content="Word.Document"> would map to the icon that is specified for the ProgId "Word.Document" by a Mapping element inside the ByProgID element.

    <Mapping Key="Word.Document" Value="ichtmdoc.gif"/>

For an extended example that shows how to use the ByProgID element, see DocIcons element (Document Icons).