diff --git a/packages/charts/src/components/TimelineChart/Placeholder.tsx b/packages/charts/src/components/TimelineChart/Placeholder.tsx
index 7d87a2a3703..0233208dd51 100644
--- a/packages/charts/src/components/TimelineChart/Placeholder.tsx
+++ b/packages/charts/src/components/TimelineChart/Placeholder.tsx
@@ -1,6 +1,9 @@
import { ThemingParameters } from '@ui5/webcomponents-react-base';
import ContentLoader from 'react-content-loader';
+/**
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
+ */
export const TimelineChartPlaceholder = () => {
return (
// @ts-expect-error: TypeScript is going crazy
diff --git a/packages/charts/src/components/TimelineChart/TimeLineChart.mdx b/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
index 05052a2bb2c..473b9c0ed5f 100644
--- a/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
+++ b/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
@@ -6,7 +6,7 @@ import { TimelineChartAnnotation } from './TimelineChartAnnotation';
-
+
diff --git a/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx b/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
index 793856429ff..e228a8f39ca 100644
--- a/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
+++ b/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
@@ -8,7 +8,7 @@ import { TimelineChart } from './index.js';
const meta = {
title: 'TimelineChart',
component: TimelineChart,
- tags: ['package:@ui5/webcomponents-react-charts', 'experimental'],
+ tags: ['package:@ui5/webcomponents-react-charts', 'experimental', 'deprecated'],
argTypes: {
dataset: {
control: { disable: true },
diff --git a/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx b/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
index 9e5d6d3d1e0..92c353b97d9 100644
--- a/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
+++ b/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
@@ -46,6 +46,8 @@ interface TimelineChartAnnotationProps extends CommonProps {
/**
* This is designed to be used for creating custom annotations, markers
* or illustrations on the timeline of the chart.
+ *
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
*/
const TimelineChartAnnotation = forwardRef((props, ref) => {
const { width = 'auto', height, rowIndex = 0, rowHeight = DEFAULT_ROW_HEIGHT, figure, ...rest } = props;
diff --git a/packages/charts/src/components/TimelineChart/index.tsx b/packages/charts/src/components/TimelineChart/index.tsx
index aa837d4c90c..b1142ddbd98 100644
--- a/packages/charts/src/components/TimelineChart/index.tsx
+++ b/packages/charts/src/components/TimelineChart/index.tsx
@@ -109,9 +109,6 @@ export interface TimelineChartProps extends CommonProps {
/**
* > __Experimental Component!__
- * > This component is experimental and not subject to semantic versioning.
- * > Therefore, you could face breaking changes when updating versions.
- * > Please use with caution!
*
* A `TimelineChart` is a data visualization chart that can be used to represent
* Gantt charts or any other timeline-based visualizations. The component has a
@@ -125,6 +122,8 @@ export interface TimelineChartProps extends CommonProps {
* connections.
*
* __Note:__ Charts are custom-built __without__ defined design specifications! They use the Fiori color palette, but functionality and especially accessibility may not meet standard app requirements.
+ *
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
*/
const TimelineChart = forwardRef(
(