[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
 [Expand]Getting Started
 [Collapse]Basic Concepts and Terminology
   DevExpress Dashboard Architecture
   Dashboard Designer
   Dashboard Viewer
   Dashboard Items
   Data Sources
   Measures and Dimensions
 [Expand]Main Features
 [Expand]Building the Designer and Viewer Applications
 [Expand]Creating Dashboards
 [Expand]Design-Time Features
  Video Tutorials
  End-User Documentation
 [Expand]Redistribution and Deployment
 [Expand]Member Tables
 [Expand]API Reference
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More


The dashboard is the main component of the DevExpress Dashboard Suite. The dashboard visualizes data using different types of elements (dashboard items) - charts, grids and pivot tables, maps, etc. - and allows users to interact with these elements. For example, users can filter a dashboard using the Master Filtering feature, perform a drill-down to change the detail level of data, use dynamic parameters, etc.

The DevExpress Dashboard Suite provides the following tools for creating, publishing and using dashboards.

  • The Dashboard Designer allows end-users to create dashboards using the required platform (WinForms or Web). The resulting dashboard is an XML definition containing the full dashboard description.
  • The Dashboard Viewer can be used to publish the created dashboard on any of the required platforms such as WinForms, ASP.NET or ASP.NET MVC.

In code, the dashboard is represented by the Dashboard class.

Expanded Dashboard XML Definition

The dashboard XML definition is a set of settings that describe the dashboard and include data source information, dashboard items, layout and so on. The XML definition is generated by the Dashboard Designer application. The Dashboard Viewer uses this definition to display the dashboard to end-users.


If necessary, the dashboard XML definition can be extended by custom elements using the Dashboard.UserData property. In this case, you should provide interpretation logic for loading this dashboard into the Dashboard Viewer.

Expanded Dashboard Component

The dashboard component is the descendant of the Dashboard class containing the dashboard description. The dashboard component is created at Visual Studio design time and can be used to embed the dashboard into the current application. If necessary, you can save this dashboard to an XML file.

Expanded Creating a Dashboard in Code

As was mentioned earlier, the dashboard is represented by the Dashboard class. This class exposes various members that allow you to create the dashboard in code from scratch. For instance, the Dashboard.DataSources property provides access to dashboard data sources; the Dashboard.Items property exposes dashboard items that will be displayed within the dashboard. You can generate a dashboard XML definition from the Dashboard object using the Dashboard.SaveToXml method. The Dashboard.LoadFromXml method initializes the Dashboard object based on the existing XML definition.

Is this topic helpful?​​​​​​​