Edit the customizations XML file with schema validation

The customizations.xml file is included within the compressed .zip file exported as a solution. Certain portions of the customizations.xml file can be edited manually. Information about the schema helps you confirm that any modifications you make are valid.

XSD schema files

Download the schemas for the XSD schema files used to validate the customization.xml file in a solution. The necessary files are:

  • CustomizationsSolution.xsd

  • fetch.xsd

  • FormXml.xsd

  • isv.config.xsd

  • RibbonCore.xsd

  • RibbonTypes.xsd

  • RibbonWSS.xsd

  • SiteMap.xsd

  • SiteMapType.xsd

  • VisualizationDataDescription.xsd

    These files are also installed on the on-premises Dynamics 365 for Customer Engagement server at: [Install Drive]\Program Files\Microsoft Dynamics CRM\Server\ApplicationFiles

  CustomizationsSolution.xsd is the schema for the exported solution. It contains references to the other XSD files. All the files should be located in the same folder.

Using schema validation

Because the exported XML is a text file, you can edit it using a text editor such as Notepad. However, we strongly recommend that you use an application that supports XSD schema validation such as Visual Studio. XSD validation in Visual Studio or Visual Studio Express 2012 for Web provides IntelliSense information and schema validation to help prevent errors.

The XSD schema files that are used to validate the customization.xml file in a solution are available here. Download the schemas. Make sure to copy all the files from that folder into the same directory. You will need to associate the customizations.xml file to the CustomizationsSolution.xsd file. That file has links to all the other XSD files in the folder.

  1. Download the XSD schema files and copy all of them to your computer. Save them in the location that Visual Studio uses for XSD validation files. This location is probably [install drive]\Program Files (x86)\Microsoft Visual Studio X.0\Xml\Schemas where X represents the version of Visual Studio.

  2. Right-click the customizations.xml file and select Open With and then select the version of Visual Studio.

  3. Select View and then select Properties Window.

  4. In the Properties window, in the Schemas field, click the ellipsis [...] button.

  5. In the Xml Schemas dialog box you should see the customizationsSolution.xsd. In the Use column, select Use this schema.

    Note

    If you do not see it, click Add and browse to where you saved it.

  6. Click OK.

    You are now ready to begin editing the XML with XSD validation.

See also

When to Edit the Customizations File for Dynamics 365 Customer Engagement
Ribbon core schema Ribbon types schema Ribbon WSS schema SiteMap schema
Form XML schema
ISV Configuration File Schema
Build Queries with FetchXML