[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
    [Expand]Creating Charts
    [Collapse]Chart Elements
     [Collapse]Chart Titles
       Chart Titles Overview
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Chart Titles Overview

This document describes how chart titles can be created and customized, and illustrates their general functionality.

Expanded Overview

Chart titles are used to accompany your chart with text headers and explanations. You can display an unlimited number of titles within a single chart.


If a chart title's length exceeds the size of the chart, you can force the title's text to be wrapped in multiple lines from the DockableTitle.WordWrap property.

In addition, chart titles provide HTML support, allowing you to apply HTML formatting to your chart's titles using standard HTML tags.

To learn more on HTML support, refer to the HTML Text Formatting topic.

The section below describes how to create chart titles at design time.

Expanded Creation

To access a chart's titles collection at design time, do the following.

  • Select the chart control, and in the Properties window, locate the WebChartControl.Titles property.
  • Click the title's ellipsis button.

  • The Chart Title Collection Editor will appear.

In this dialog, use the Add button to create chart titles.

After a title is created, you can customize its appearance and behavior.

Expanded Customization

To customize a chart title, use the following properties.

  • The title's text is determined by the Title.Text property. You can format a chart's title with standard HTML tags. To see a list of HTML tags, refer to HTML Text Formatting.

  • The appearance of a title's text can be customized from the TitleBase.Font, TitleBase.Antialiasing and TitleBase.TextColor properties. Note that the color defined by a title's HTML <color> tags have priority over the title's TitleBase.TextColor property setting.

  • The placement of titles within a chart is determined by their DockableTitle.Alignment and DockableTitle.Dock properties.

  • To define the spacing around a title (in pixels), define its DockableTitle.Indent property.

  • To enable automatic word wrapping for lengthy chart titles, use the DockableTitle.WordWrap property.

    After you enable word wrapping, the DockableTitle.MaxLineCount property comes into effect. This property allows you to determine the limit for new lines appearing when a title's text is wrapped. Note that if a title's length exceeds this limit, the last line of text will be cut off by an ellipsis.

    If required, you can increase the DockableTitle.MaxLineCount property value so that the entire text will fit. However, if the number of lines is increased, the chart's diagram size will decrease as a result.

  • To hide a title while maintaining it in the collection, disable its TitleBase.Visible property.

Expanded See Also

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