Create a Predefined Dashboard and Add it to the Navigation - Devexpress

Feb 20, 2026
2 minutes to read

This topic describes how to provide a predefined dashboard that is available to users immediately after application deployment.

Create a dashboard at runtime. You can review the following topics to learn how to do it.
Save the dashboard to an XML file.
Add the created XML file to the module project as a resource file.
Open the Updater.cs file and add the following code to the ModuleUpdater.UpdateDatabaseAfterUpdateSchema method.
Run the Model Editor. To add the dashboard to a certain navigation group, right-click its Items child node, and choose Add… | DashboardNavigationItem.
Focus the created node and set the IModelDashboardNavigationItem.DashboardTitle property to the title of the required dashboard.
Run the application to ensure that the dashboard is added to the navigation.

Tip

If you are going to use predefined dashboards only, you can remove the Dashboards List View from the navigation. Set the DashboardsModule.GenerateNavigationItem property to false for this purpose.