Skip to content

UG documentation 999325: How to position the legend, chart title, and axis title on a chart using XlsIO #3197

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
VinothSF5015 wants to merge 2 commits into
base: hotfix/hotfix-v33.2.3
Choose a base branch
from
Open

UG documentation 999325: How to position the legend, chart title, and axis title on a chart using XlsIO #3197

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
11cdb94
Content Added
VinothSF5015 Jun 3, 2026
c31c39e
Update how-to-position-the-legend-chart-title-and-axis-title-on-a-cha…
VinothSF5015 Jun 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
191 changes: 191 additions & 0 deletions ...ry/NET/faqs/how-to-position-the-legend-chart-title-and-axis-title-on-a-chart.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,191 @@
---
title: Positioning Legend, Chart and Axis Titles | Syncfusion
description: This page explains how to position the legend, chart title, and axis title on a chart using Syncfusion XlsIO library in Excel documents.
platform: document-processing
control: XlsIO
documentation: UG
---

# How to Position Legend, Chart Title, and Axis Titles on a Chart?

The legend can be placed at preset positions such as Top, Bottom, Left, Right, or Corner using the `Position` property. For finer control over the chart title, the `Layout` property allows setting exact left and top positions in points.

The following code example illustrates positioning the legend at the left, chart title at a specific location, and axis titles on a chart.

{% tabs %}
{% highlight c# tabtitle="C# [Cross-platform]" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
// Instantiate the Excel application object
IApplication application = excelEngine.Excel;

// Assign default application version
application.DefaultVersion = ExcelVersion.Xlsx;

// Open an existing workbook
IWorkbook workbook = application.Workbooks.Open(Path.GetFullPath(@"Data/InputTemplate.xlsx"), ExcelOpenType.Automatic);

// Access the first worksheet
IWorksheet sheet = workbook.Worksheets[0];

// Create a chart
IChartShape chart = sheet.Charts.Add();

// Set chart type
chart.ChartType = ExcelChartType.Column_Clustered;

// Set data range in the worksheet
chart.DataRange = sheet.Range["A1:C6"];
chart.IsSeriesInRows = false;

// Set data labels for series 1
IChartSerie serie1 = chart.Series[0];
IChartSerie serie2 = chart.Series[1];
serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
serie1.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside;

// Set data labels for series 2
serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
serie2.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside;

// Set chart title
chart.ChartTitle = "Sales Analysis";

// Set legend and position it at the left
chart.HasLegend = true;
chart.Legend.Position = ExcelLegendPosition.Left;

// Position the chart in the worksheet
chart.TopRow = 8;
chart.LeftColumn = 1;
chart.BottomRow = 23;
chart.RightColumn = 8;

// Manual layout positioning of the chart title
chart.ChartTitleArea.Layout.LeftMode = LayoutModes.edge;
chart.ChartTitleArea.Layout.TopMode = LayoutModes.edge;
chart.ChartTitleArea.Layout.Left = 100;
chart.ChartTitleArea.Layout.Top = 20;

// Save the workbook to disk in XLSX format
workbook.SaveAs(Path.GetFullPath("Output/Chart.xlsx"));
}
{% endhighlight %}
{% highlight c# tabtitle="C# [Windows-specific]" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
// Instantiate the Excel application object
IApplication application = excelEngine.Excel;

// Assign default application version
application.DefaultVersion = ExcelVersion.Xlsx;

// Open an existing workbook
IWorkbook workbook = application.Workbooks.Open("InputTemplate.xlsx", ExcelOpenType.Automatic);

// Access the first worksheet
IWorksheet sheet = workbook.Worksheets[0];

// Create a chart
IChartShape chart = sheet.Charts.Add();

// Set chart type
chart.ChartType = ExcelChartType.Column_Clustered;

// Set data range in the worksheet
chart.DataRange = sheet.Range["A1:C6"];
chart.IsSeriesInRows = false;

// Set data labels for series 1
IChartSerie serie1 = chart.Series[0];
IChartSerie serie2 = chart.Series[1];
serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
serie1.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside;

// Set data labels for series 2
serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
serie2.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside;

// Set chart title
chart.ChartTitle = "Sales Analysis";

// Set legend and position it at the left
chart.HasLegend = true;
chart.Legend.Position = ExcelLegendPosition.Left;

// Position the chart in the worksheet
chart.TopRow = 8;
chart.LeftColumn = 1;
chart.BottomRow = 23;
chart.RightColumn = 8;

// Manual layout positioning of the chart title
chart.ChartTitleArea.Layout.LeftMode = LayoutModes.edge;
chart.ChartTitleArea.Layout.TopMode = LayoutModes.edge;
chart.ChartTitleArea.Layout.Left = 100;
chart.ChartTitleArea.Layout.Top = 20;

// Save the workbook to disk in XLSX format
workbook.SaveAs("Chart.xlsx");
}
{% endhighlight %}
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
Using excelEngine As New ExcelEngine()
' Instantiate the Excel application object
Dim application As IApplication = excelEngine.Excel

' Assign default application version
application.DefaultVersion = ExcelVersion.Xlsx

' Open an existing workbook
Dim workbook As IWorkbook = application.Workbooks.Open("InputTemplate.xlsx", ExcelOpenType.Automatic)

' Access the first worksheet
Dim sheet As IWorksheet = workbook.Worksheets(0)

' Create a chart
Dim chart As IChartShape = sheet.Charts.Add()

' Set chart type
chart.ChartType = ExcelChartType.Column_Clustered

' Set data range in the worksheet
chart.DataRange = sheet.Range("A1:C6")
chart.IsSeriesInRows = False

' Set data labels for series 1
Dim serie1 As IChartSerie = chart.Series(0)
Dim serie2 As IChartSerie = chart.Series(1)
serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = True
serie1.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside

' Set data labels for series 2
serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = True
serie2.DataPoints.DefaultDataPoint.DataLabels.Position = ExcelDataLabelPosition.Outside

' Set chart title
chart.ChartTitle = "Sales Analysis"

' Set legend and position it at the left
chart.HasLegend = True
chart.Legend.Position = ExcelLegendPosition.Left

' Position the chart in the worksheet
chart.TopRow = 8
chart.LeftColumn = 1
chart.BottomRow = 23
chart.RightColumn = 8

' Manual layout positioning of the chart title
chart.ChartTitleArea.Layout.LeftMode = LayoutModes.edge
chart.ChartTitleArea.Layout.TopMode = LayoutModes.edge
chart.ChartTitleArea.Layout.Left = 100
chart.ChartTitleArea.Layout.Top = 20

' Save the workbook to disk in XLSX format
workbook.SaveAs("Chart.xlsx")
End Using
{% endhighlight %}
{% endtabs %}

A complete working example in C# is present on <a href="https://github.com/SyncfusionExamples/XlsIO-Examples/tree/999325-ChartPosition/FAQ/ChartPropertyPositioning/.NET/ChartPropertyPositioning">this GitHub page</a>.