# Axes

Chart axes provide the foundation for data visualization by establishing scales and reference points for your plotted data. They define how data values are mapped to visual positions and provide labels to help users interpret the information.

## Chart Layouts and Axes

The Chart supports four layout groups, and each group uses different axes and data shapes.

* Categorical—Uses category axis and value axis. Series such as [Line](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/line) and [Bar](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/bar) plot values against categories (strings or dates).
* Numeric (XY)—Uses X axis and Y axis. Series such as [Scatter](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/scatter) and [Bubble](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/bubble) plot numeric `x` and `y` values on Cartesian axes.
* Polar—Uses polar axes. Series plot numeric `x` and `y` values where `x` represents angle and `y` represents radius.
* Axis-free—No axes. Series such as [Pie](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/pie) and [Donut](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/donut) display data without coordinate systems. Categories appear in the legend.

## Categorical Chart Axes

Category axes are declared through the [kendo-chart-category-axis-item](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent) configuration components and placed in a [kendo-chart-category-axis](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxiscomponent) collection. For more information on the available data-binding options, refer to the section on [binding to series](https://www.telerik.com/kendo-angular-ui/components/charts/data-binding/binding-series) article.

Value axes are declared through the [kendo-chart-value-axis-item](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxisitemcomponent) configuration components and placed in a [kendo-chart-value-axis](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxiscomponent) collection.

### Categorical Chart Axes Configuration

To configure categorical chart axes, you need to set up both the value axis (for numeric data) and category axis (for labels). The value axis defines the scale and range for your data, while the category axis provides the labels for each data point.

The following example demonstrates how to configure the value and category axes of the category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/elements/axes/source.txt)

### Multiple Categorical Chart Axes

The Angular Chart enables you to render multiple axes by either:

* Adding multiple `kendo-chart-value-axis-item` or `kendo-chart-category-axis-item` components to their respective container, or
* Providing an array of axis options for the [`valueAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/chartcomponent#valueaxis) or [`categoryAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/chartcomponent#categoryaxis) inputs.

To associate a series with a particular value axis, set the [`name`](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxisitemcomponent#name) of the axis to the [`axis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#axis) option of the series. To specify the category axis, which the series will use, set the [`name`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#name) of the axis to the [`categoryAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#categoryaxis) option of the series. If you do not specify the axes, the series will use the first value and category axes.

For information on positioning axes relative to one another, refer to the [Axis Positioning](https://www.telerik.com/kendo-angular-ui/components/charts/elements/axes#axis-positioning) section.

The following example demonstrates multiple axes for the Category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/multiple-category/source.txt)

### Grid Lines and Ticks

Grid lines and ticks help users read values from the Chart by providing visual reference across the plot area. The Chart renders major grid lines and major ticks by default. Minor grid lines and minor ticks are hidden by default.

Configure grid lines through the [`majorGridLines`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#majorgridlines) and [`minorGridLines`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#minorgridlines) properties, which accept a [`GridLines`](https://www.telerik.com/kendo-angular-ui/components/charts/api/gridlines) object. Configure ticks through the [`majorTicks`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#majorticks) and [`minorTicks`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#minorticks) properties, which accept an [`AxisTicks`](https://www.telerik.com/kendo-angular-ui/components/charts/api/axisticks) object. Both objects share the `visible`, `color`, `width`, `skip`, and `step` options. Grid lines add a `dashType` option for the line style, while ticks add a `size` option for the tick length in pixels.

Use `step` to reduce visual density on axes that have many data points. For example, a `step` of `2` renders every other grid line or tick. Use `skip` to hide lines or ticks at the beginning of the axis, for example, when the first grid line overlaps the axis itself.

The following example demonstrates how to configure grid lines and ticks on both axes. Use the controls to toggle visibility, change the dash type, set colors, and adjust the `skip` and `step` values.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/grid-lines-and-ticks/source.txt)

### Label Position of the Categorical Chart Axes

The category and value axes provide options for displaying their labels either next to the axis or at the outer edges of the plot area. By default, the labels are positioned next to the axis.

To change the label position, set the [`position`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxislabels#position) option of the axis labels:

* When `position` is set to `end`, the labels are placed at the end of the crossing axis. Typically, this configuration positions the labels at the top or right end of the Chart unless the crossing axis was reversed.
* When `position` is set to `start`, the labels are placed at the start of the crossing axis. Typically, this configuration positions the labels at the left or bottom end of the Chart unless the crossing axis was reversed.

The following example demonstrates different label positions for the Category Chart axes.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/label-position-category/source.txt)

### Displaying Time Series

The Category axis delivers the following dedicated features, which are tailored for displaying time series and get automatically activated when the axis is bound to [`Date`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) objects.

> To disable the Category axis features for displaying time series, set the axis [mode](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#type) to `"category"`.

The following example demonstrates how to configure the Category axis for time series data.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/date-categories/source.txt)

#### Selecting Time Intervals for Category Charts

When the Category Chart is set to display time series, the Category axis divides into time slots. To set the time scale for these slots, define a base unit, which can be hours, days, weeks, and so on. By default, the base unit matches the smallest time interval between the source dates. This approach ensures that all data points that are present in the original series will be displayed as they are.

You can use the [`baseUnit`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#baseunit) setting to manually select a different time unit. To display every N<sup>th</sup> base unit, set the [`baseUnitStep`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#baseunitstep) option.

Setting the base unit to `"fit"`, limits the total number of categories either to the set [`maxDateGroups`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#maxdategroups) value or, otherwise, to the default `maxDateGroups` value of 10.

The following example demonstrates how to configure the time scale of the Category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/date-units/source.txt)

#### Customizing Automatic Base Unit Steps

When the `baseUnit` is set to `"fit"` or `"auto"`, the Chart selects the optimal time interval from a set of predefined steps. The [`autoBaseUnitSteps`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#autobaseunitsteps) property allows you to customize these steps and control which time intervals the Chart considers.

The Chart divides the active time range into the smallest possible intervals that do not exceed the [`maxDateGroups`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#maxdategroups) value. For each base unit (days, weeks, months, and so on), the `autoBaseUnitSteps` configuration defines an array of allowed step multipliers. Set an empty array for a base unit to prevent the Chart from using that time interval.

The default `autoBaseUnitSteps` configuration is:

```ts
// Each array lists the allowed step multipliers for its time unit.
autoBaseUnitSteps: AutoBaseUnitSteps = {
    milliseconds: [1, 10, 100],
    seconds: [1, 2, 5, 15, 30],
    minutes: [1, 2, 5, 15, 30],
    hours: [1, 2, 3],
    days: [1, 2, 3],
    weeks: [1, 2],
    months: [1, 2, 3, 6],
    years: [1, 2, 3, 5, 10, 25, 50]
};
```

The following example demonstrates how different `autoBaseUnitSteps` configurations affect the Chart grouping. Select a preset to see how removing or restricting available intervals forces the Chart to fall back to coarser groupings—from biweekly, to monthly, bimonthly, and quarterly.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/auto-base-unit-steps/source.txt)

#### Aggregating Data

When the Category Chart is set to display time series, it processes the data points for each time slot and produces a new point by using an aggregate function.

By default, the [`aggregate`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#aggregate) function returns the maximum value of the value fields. If the category contains only one point, `aggregate` returns the point without modification. Other aggregates, such as `count` and `sum`, produce their own value even if the category contains only one data point.

The following example demonstrates different `aggregate` functions for the Category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/date-aggregates/source.txt)

#### Limiting the Number of Labels

Normally, each date interval gets its own label. Labels may overlap and become illegible in densely populated charts. To work around this issue, set an upper limit to the number of labels for display by using the [`maxDivisions`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#maxdivisions) option.

The following example demonstrates how to configure the `maxDivisions` option for the Category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/max-divisions/source.txt)

You can save space and rotate the labels at a fixed or at an optimal (`"auto"`) angle by using the [`labels.rotation`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxislabels#rotation) option.

The following example demonstrates different label rotation options for the Category Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/label-rotation/source.txt)

#### Displaying the Axis Date Range

To display the exact start and end date of the axis range, set the [`rangeLabels.visible`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisrangelabels#visible) setting to `true`.

The range labels support the same settings as the axis labels. If an option is not set, it will default to the value set for the regular labels. For example [`rangeLabels.color`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisrangelabels#color) defaults to the value of [`labels.color`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxislabels#color).

Toggle the range labels in the example below to see how they differ from the regular axis labels:

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/range-labels/source.txt)

### Category Axis Highlight

The category axis supports a [`highlight`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#highlight) property that renders a colored rectangle over the hovered category column. Configure it through a [`CategoryAxisHighlight`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxishighlight) object with the following options:

* `visible`—Shows or hides the highlight rectangle.
* `color`—Sets the fill color. Accepts any valid CSS color string, including HEX and RGB.
* `opacity`—Controls fill transparency. The value ranges from `0` (fully transparent) to `1` (fully opaque).
* `border`—Configures the highlight border through a [`Border`](https://www.telerik.com/kendo-angular-ui/components/charts/api/border) object that accepts `color`, `width`, `dashType`, and `opacity`.

The following example demonstrates the category axis highlight. Use the controls to toggle visibility and adjust the fill and border options.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/category-axis-highlight/source.txt)

## Scatter Chart Axes

Scatter charts use X and Y axes to plot data points in a two-dimensional coordinate system. Unlike categorical charts that use categories and values, scatter charts position data based on numeric coordinates on both axes, making them ideal for showing relationships between two continuous variables.

Both X and Y axes are declared through their respective [kendo-chart-x-axis-item](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxisitemcomponent) and [kendo-chart-y-axis-item](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxisitemcomponent) configuration components, which are placed in [kendo-chart-x-axis](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxiscomponent) and [kendo-chart-y-axis](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxiscomponent) collections respectively.

### Scatter Chart Axes Configuration

To configure scatter chart axes, you need to set up both the X axis (horizontal positioning) and Y axis (vertical positioning). Both axes can be customized with ranges, labels, formatting, grid lines, and other visual elements to create clear and informative visualizations.

The following example demonstrates how to configure the X and Y axes of the Scatter Chart with comprehensive styling options including axis ranges, label formatting, and grid line customization.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/scatter-chart-axes-config/source.txt)

### Multiple Scatter Chart Axes

The Angular Chart enables you to render multiple axes either by:

* Adding multiple `kendo-chart-x-axis-item` or `kendo-chart-y-axis-item` components to their respective container, or
* Providing an array of axis options for the [`xAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/chartcomponent#valueaxis) or [`yAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/chartcomponent#yaxis) inputs.

To associate a series with a particular X axis, set the [`name`](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxisitemcomponent#name) of the axis to the [`xAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#xaxis) option of the series. To specify the Y axis, which the series will use, set the [`name`](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxisitemcomponent#name) of the axis to the [`yAxis`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#yaxis) option of the series. If you do not specify the axes, the series will use the first X and Y axes.

For information on positioning axes relative to one another, refer to the [Axis Positioning](https://www.telerik.com/kendo-angular-ui/components/charts/elements/axes#axis-positioning) section.

The following example demonstrates multiple axes for the Scatter Chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/multiple-scatter/source.txt)

### Label Position of the Scatter Chart Axes

The X and Y axes provide options for displaying their labels either next to the axis or at the outer edges of the plot area. By default, the labels are positioned next to the axis.

To change the label position, set the [`position`](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxislabels#position) option of the axis labels:

* When `position` is set to `end`, the labels are placed at the end of the crossing axis. Typically, this configuration positions the labels at the top or right end of the Chart unless the crossing axis was reversed.
* When `position` is set to `start`, the labels are placed at the start of the crossing axis. Typically, this configuration positions the labels at the left or bottom end of the Chart unless the crossing axis was reversed.

The following example demonstrates different label positions for the Scatter Chart axes.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/label-position-scatter/source.txt)

### Displaying Dates

Scatter charts can display date and time data on both X and Y axes. The chart automatically recognizes Date objects and provides specialized formatting and scaling options for time-based visualizations.

#### Using the X and Y Axes

Both X and Y axes can display date values effectively for time series data or temporal correlations. The chart handles date formatting and axis scaling automatically while allowing customization of time intervals through the `baseUnit` property.

The following example demonstrates how to use the X and Y axes of the Chart to display dates.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/date-values/source.txt)

#### Selecting Time Intervals for Scatter Charts

When the Scatter Chart is set to display time series, its axis divides into time slots. To set the time scale for these slots, define a "base unit", which can be hours, days, weeks, and so on.

You can use the [`baseUnit`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#baseunit) setting to manually select a different time unit. To display every N-th base unit, set the [`baseUnitStep`](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent#baseunitstep) option.

> The `baseUnit` setting for the Scatter Charts affects only the axis labels. This behavior contrasts the settings of the [Categorical Chart axes](https://www.telerik.com/kendo-angular-ui/components/charts/elements/axes#categorical-chart-axes) that are used by the Chart to compute time series aggregates.

## Axis Positioning

The [`axisCrossingValue`](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxisitemcomponent#axiscrossingvalue) property determines where axes intersect and controls their positioning on the chart. This is particularly useful when you have multiple axes and want to position them on different sides of the chart.

Here are some key points about the `axisCrossingValue` property:

* 0 or values below the range—positions the axis at the start edge (left for value axes, bottom for category axes).
* Large values above the range—positions the axis at the end edge (right for value axes, top for category axes).
* Values within the range—draws the axis through that specific point, useful for centering or custom positioning.
* For categorical charts—numbers are category indices where 0 is the first category.
* For scatter charts—numbers are actual coordinate values on the perpendicular axis.
* Arrays—when multiple perpendicular axes exist, each array item applies to the respective axis.

The following example demonstrates different `axisCrossingValue` configurations including positioning all axes on one side, splitting axes between left and right, and centering axes at specific crossing points.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/axis-positioning/source.txt)

## Default Axis Configuration

You can also apply settings to all Chart axes, regardless of their kind, by using the [kendo-chart-axis-defaults](https://www.telerik.com/kendo-angular-ui/components/charts/api/axisdefaultscomponent) component.

The kendo-chart-axis-defaults component supports the following child components:

* [kendo-chart-axis-defaults-crosshair](https://www.telerik.com/kendo-angular-ui/components/charts/api/axisdefaultscrosshaircomponent)
* [kendo-chart-axis-defaults-labels](https://www.telerik.com/kendo-angular-ui/components/charts/api/axisdefaultslabelscomponent)
* [kendo-chart-axis-defaults-title](https://www.telerik.com/kendo-angular-ui/components/charts/api/axisdefaultstitlecomponent)

The following example demonstrates how to configure the default axis settings.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/default-axis-config/source.txt)

## Creating a Logarithmic Axis

The Angular Chart allows you to create a logarithmic axis to display data that varies over several orders of magnitude. To create a logarithmic axis, you can set the [`type`](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxisitemcomponent#type) property to `log` on value axes (for categorical charts) or on X and Y axes (for scatter charts) using [`kendo-chart-x-axis-item`](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxisitemcomponent#type) and [`kendo-chart-y-axis-item`](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxisitemcomponent#type) respectively.

Logarithmic axes are particularly useful when:

* Data spans multiple orders of magnitude (e.g., from thousands to billions).
* You need to visualize exponential relationships.
* Small values would be invisible on a linear scale.

The following example demonstrates how to create a logarithmic value axis for categorical charts, showing earthquake energy data across different magnitudes.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/logarithmic-axes/source.txt)

The following example demonstrates logarithmic axes for scatter charts using population versus GDP per person data, where both axes use logarithmic scaling to effectively display data spanning multiple orders of magnitude.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/chart/axes/logarithmic-axes-scatter/source.txt)

## Support and Learning Resources

* [Chart Axes Homepage](https://www.telerik.com/kendo-angular-ui/charts#axes)
* [Getting Started with the Kendo UI for Angular Chart](https://www.telerik.com/kendo-angular-ui/components/charts/installation/getting-started)
* [API Reference of the Chart](https://www.telerik.com/kendo-angular-ui/components/charts/api)
* [Chart Area](https://www.telerik.com/kendo-angular-ui/components/charts/elements/chart-area)
* [Crosshairs](https://www.telerik.com/kendo-angular-ui/components/charts/elements/crosshairs)
* [Error Bars](https://www.telerik.com/kendo-angular-ui/components/charts/elements/crosshairs)
* [Labels](https://www.telerik.com/kendo-angular-ui/components/charts/elements/labels)
* [Legend](https://www.telerik.com/kendo-angular-ui/components/charts/elements/legend)
* [Notes](https://www.telerik.com/kendo-angular-ui/components/charts/elements/notes)
* [Panes](https://www.telerik.com/kendo-angular-ui/components/charts/elements/panes)
* [Plot Area](https://www.telerik.com/kendo-angular-ui/components/charts/elements/plot-area)
* [Plot Bands](https://www.telerik.com/kendo-angular-ui/components/charts/elements/plot-bands)
* [Selection](https://www.telerik.com/kendo-angular-ui/components/charts/elements/selection)
* [Series](https://www.telerik.com/kendo-angular-ui/components/charts/elements/series)
* [Title](https://www.telerik.com/kendo-angular-ui/components/charts/elements/title)
* [Tooltip](https://www.telerik.com/kendo-angular-ui/components/charts/elements/tooltips)
* [Getting Started with Kendo UI for Angular (Online Guide)](https://www.telerik.com/kendo-angular-ui/components/getting-started)
* [Getting Started with Kendo UI for Angular (Video Tutorial)](https://www.telerik.com/campaigns/kendo-ui/using-kendo-ui-with-angular-video-tutorial)
* [Video Courses](https://www.telerik.com/kendo-angular-ui/components/getting-started/video-onboarding)
* [Chart Forum](https://www.telerik.com/forums/kendo-angular-ui?tagId=256)
* [Before You Start: All Things Angular (Telerik Blog Post)](https://www.telerik.com/blogs/all-things-angular)
* [Knowledge Base](https://www.telerik.com/kendo-angular-ui/components/knowledge-base)

## Additional Resources

* [Angular Blogs](https://www.telerik.com/blogs/tag/kendo-ui-for-angular)
* [Angular Videos](https://www.telerik.com/videos/kendo-angular-ui)
* [Kendo UI for Angular Roadmap](https://www.telerik.com/support/whats-new/kendo-angular-ui/roadmap)
