policyDefinitionResources Element

Applies To: Windows Server 2008

The policyDefinitionResources element is the document element for an .adml file that defines all the localized resource information with a single language/culture per file for each supported language/culture setting. The policyDefinitionResources element also declares a default namespace for all of the elements in the .adml file.


<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="<MajorVerison.MinorVersion>" schemaVersion="<MajorVerison.MinorVersion>" xmlns= "http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" >
  <displayName> … </displayName>
  <description> … </description>
  <annotation> … </annotation>
  <resources> … </resources>


Attributes Required Description

xmlns Attribute


xmlns:xsd ="http://www.w3.org/2001/XMLSchema"

Designation for elements and data types used in the schema that comes from the "http://www.w3.org/2001/XMLSchema" namespace. This attribute is typed as shown.

xmlns Attribute



Designation for the "XML Schema Instance" namespace available is from the "http://www.w3.org/2001/XMLSchema-instance" namespace. This attribute is typed as shown.

revision Attribute



Version of the .admx file for tracking purposes.

schemaVersion Attribute



Schema version used by the Group Policy tools. For Windows Vista and Windows Server 2008 schemaVersion must be set as follows; schemaVersion="1.0"

xmlns Attribute


The Group Policy schema namespace.


The Group Policy tools will successfully consume the .adml file that does not include the xmlns:xsd, xmlns:xsi, and xmlns attributes. The .adml file may not validate as a fully-formed XML file if the xmlns:xsd, xmlns:xsi, and xmlns attributes are not included in the .adml file.

Child elements

Element Required Description

displayName Element


The localized friendly name of the .adml file.

description Element


The localized description of policy settings contained in the .adml file.

annotation Element


A localized comment at the beginning of the .adml file.

resources Element (.adml)


Contains the stringTable and presentationTable elements for specific MUI languages.


For simplicity of documentation, nested elements located one level down, known as child elements, will only be described for a given element.


Because the policyDefinitionResources element is the document element, it contains all the other elements in the document representing the .adml file. The XML declaration is not part of the document element.


This XML fragment is the corresponding localized resources for the single policy setting example in the policyDefinitions element.

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns=" http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions ">
  <displayName>enter display name here</displayName>
  <description>enter description here</description>
      <string id="SAMPLE">Example 1 - Simplest single Group Policy setting</string>
      <string id="Sample_NoParamPolicy">Set state only</string>
      <string id="Sample_NoParamPolicy_Help">This is an example of a Group Policy setting that only sets a value for the enabled, disabled states.

If you enable this setting, the Example1NoParam value will be set to 1.

 If you disable this setting, the Example1NoParam will be set to 0.

If you do not configure this setting, the value will be deleted, if currently set to a value.</string>
      <string id="SAMPLEHELP">Example 1

Contains an example of the simplest policy setting that can be created.

This will be displayed as both a machine and user policy setting.</string>
      <string id="SUPPORTED_ProductOnly">Only works on placeholder product</string>

Additional references

XML declaration