[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Charting Basics
   [Expand]Series Views
   [Collapse]Chart Elements
     Chart Titles
      Adding Legends
      Legends Alignment and Layout
      Legends Appearance
      Legend Title
      Legend Items
   [Expand]Providing Data
   [Expand]Data Representation
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Additional Resources
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Adding Legends

This document describes how a new additional legend can be added to a chart at design time.

To add a new legend to a chart at design time, select the chart. In the Properties window, locate the ChartControl.Legends property and click the ellipsis button. In the invoked editor, click Add.

Then, configure the legend properties. Dock it to the required pane or chart control using the Legend.DockTarget property...

... and position it using the Legend.AlignmentVertical and Legend.AlignmentHorizontal properties.

For more information about the legend layout, refer to the Legends Alignment and Layout document.

Then, assign the legend to a Series, indicator, constant line or strip using the SeriesBase.Legend, Indicator.Legend, ConstantLine.Legend or Strip.Legend property respectively.

As a result, the additional legend will be displayed.


Please note that the additional legend will not be displayed at runtime until it is assigned to a Series, indicator, constant line or strip. At design time an empty legend will be labeled by Empty Legend text.

To learn how to add additional legends at runtime, refer to the How to: Add an Additional Legend to a Chart example.

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