Customize SiteMaps

The SiteMap provides the structure for navigation in Dynamics 365 for Customer Engagement. The SiteMap entity stores information about the site map, and the SiteMap.SiteMapXml attribute stores the XML that defines the site map. The site map XML is exposed as the SiteMap node in the customizations.xml file of an exported unmanaged solution.

The structure of navigation defined in the site map XML is evaluated together with your security privileges to display navigation options in the application. If your security privileges do not provide read access to an entity specified in the site map XML, the navigation option will not be displayed to you.

With the introduction of modular business apps in the December 2016 Update for Dynamics 365 (online), where each app has its own custom navigation and elements defined, there are two types of site maps now available in Dynamics 365:

  • Default site map that contains the navigation information for the default app (Dynamics 365 - custom). This site map controls the navigation for your default Dynamics 365 instance.

  • App-specific site maps that contain navigation information for a modular business app.

    You can use the SiteMap.IsAppAware attribute to distinguish between the two types of site maps: 0 indicates the default site map; 1 indicates the app-specific site map.

    You can edit the default and app-specific site maps to change the application navigation, edit labels, add or change icons, or add or remove elements. More information: Change application navigation using the SiteMap

    You can use a site map editor or programmatically update site map.

In This Section

Change application navigation using the SiteMap

Pass parameters to a URL using the SiteMap

SiteMap schema

See also

Customize Microsoft Dynamics 365 Customer Engagement applications