Customize SiteMaps


Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

The SiteMap provides the structure for navigation in Microsoft Dynamics 365. 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 Microsoft 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. More information:  Edit the site map

In This Section

Change application navigation using the SiteMap

 Edit the site map

Pass parameters to a URL using the SiteMap

Control access to the Help & Training site

SiteMap XML reference

SiteMap schema

See Also

Customize Microsoft Dynamics 365 applications
Define access permission for modular business apps in Dynamics 365

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright