Custom Metadata Keys <key>


The <key> element of the <customMetadata> element adds a custom metadata setting to the collection of custom metadata settings.

Important Note: The <customMetadata> section of the configuration should not be modified directly. Use the metabase APIs to set any metabase settings that are represented in this section.

In IIS 6.0, all of the IIS settings were kept in the metabase. In addition, any custom settings that were required by applications were stored in the metabase. In IIS 7, all IIS settings are now kept in ApplicationHost.config and Web.config Files. IIS 7 provides backwards-compatibility through the IIS 6 Metabase Compatibility feature, which is sometimes referred to as the Admin Base Object (ABO) mapper component. This feature listens for applications that attempt to write to the metabase, and maps all IIS 6.0 metabase settings to their IIS 7 equivalents. If an IIS 6.0 setting has no IIS 7 equivalent, the setting will be written to the <customMetadata> element.


Version Notes
IIS 7.5 The <key> element was not modified in IIS 7.5.
IIS 7.0 The <key> element of the <customMetadata> element was introduced in IIS 7.0.
IIS 6.0 The <customMetadata> element replaces any IIS 6.0 metabase objects that are not directly mapped to IIS 7 configuration elements.


The <customMetadata> element is not available on the default installation of IIS 7. To install it, use the following steps.

Windows Server 2008 or Windows Server 2008 R2

  1. On the taskbar, click Start, point to Administrative Tools, and then click Server Manager.
  2. In the Server Manager hierarchy pane, expand Roles, and then click Web Server (IIS).
  3. In the Web Server (IIS) pane, scroll to the Role Services section, and then click Add Role Services.
  4. On the Select Role Services page of the Add Role Services Wizard, select IIS 6 Metabase Compatibility, and then click Next.

  5. On the Confirm Installation Selections page, click Install.
  6. On the Results page, click Close.

Windows Vista or Windows 7

  1. On the taskbar, click Start, and then click Control Panel.
  2. In Control Panel, click Programs and Features, and then click Turn Windows Features on or off.
  3. Expand Internet Information Services, then select IIS Metabase and IIS 6 configuration compatibility, and then click OK.

How To

The <customMetadata> section of the configuration should not be modified directly; therefore, no examples are available.



Attribute Description
path Optional string attribute.

Specifies the path of the metabase property.

Child Elements

Element Description
property Optional element.

Adds a metabase property to the collection of metabase properties.

Sample Code

The <customMetadata> section of the configuration should not be modified directly; therefore, no examples are available.

Deprecated Elements