diff --git a/packages/tables/src/elements/Body.tsx b/packages/tables/src/elements/Body.tsx
index 85567ee5156..edbedca13f0 100644
--- a/packages/tables/src/elements/Body.tsx
+++ b/packages/tables/src/elements/Body.tsx
@@ -9,6 +9,8 @@ import React, { HTMLAttributes, forwardRef } from 'react';
 import { StyledBody } from '../styled';
 
 /**
+ * @deprecated use `Table.Body` instead
+ *
  * @extends HTMLAttributes<HTMLTableSectionElement>
  */
 export const Body = forwardRef<HTMLTableSectionElement, HTMLAttributes<HTMLTableSectionElement>>(
diff --git a/packages/tables/src/elements/Caption.tsx b/packages/tables/src/elements/Caption.tsx
index 7549766bd0a..f6bcab6262d 100644
--- a/packages/tables/src/elements/Caption.tsx
+++ b/packages/tables/src/elements/Caption.tsx
@@ -9,6 +9,8 @@ import React, { HTMLAttributes, forwardRef } from 'react';
 import { StyledCaption } from '../styled';
 
 /**
+ * @deprecated use `Table.Caption` instead
+ *
  * @extends HTMLAttributes<HTMLTableCaptionElement>
  */
 export const Caption = forwardRef<HTMLTableCaptionElement, HTMLAttributes<HTMLTableCaptionElement>>(
diff --git a/packages/tables/src/elements/Cell.tsx b/packages/tables/src/elements/Cell.tsx
index 72f69fa88b8..4ba8f8c4d50 100644
--- a/packages/tables/src/elements/Cell.tsx
+++ b/packages/tables/src/elements/Cell.tsx
@@ -12,6 +12,8 @@ import { useTableContext } from '../utils/useTableContext';
 import { ICellProps } from '../types';
 
 /**
+ * @deprecated use `Table.Cell` instead
+ *
  * @extends TdHTMLAttributes<HTMLTableCellElement>
  */
 export const Cell = React.forwardRef<HTMLTableCellElement, ICellProps>(
diff --git a/packages/tables/src/elements/GroupRow.tsx b/packages/tables/src/elements/GroupRow.tsx
index c5beaf1f317..25d9766e15e 100644
--- a/packages/tables/src/elements/GroupRow.tsx
+++ b/packages/tables/src/elements/GroupRow.tsx
@@ -10,6 +10,8 @@ import { StyledGroupRow } from '../styled';
 import { useTableContext } from '../utils/useTableContext';
 
 /**
+ * @deprecated use `Table.GroupRow` instead
+ *
  * @extends HTMLAttributes<HTMLTableRowElement>
  */
 export const GroupRow = forwardRef<HTMLTableRowElement, HTMLAttributes<HTMLTableRowElement>>(
diff --git a/packages/tables/src/elements/Head.tsx b/packages/tables/src/elements/Head.tsx
index c745448f157..dbd3f60b06b 100644
--- a/packages/tables/src/elements/Head.tsx
+++ b/packages/tables/src/elements/Head.tsx
@@ -10,6 +10,8 @@ import { StyledHead } from '../styled';
 import { IHeadProps } from '../types';
 
 /**
+ * @deprecated use `Table.Head` instead
+ *
  * @extends HTMLAttributes<HTMLTableSectionElement>
  */
 export const Head = forwardRef<HTMLTableSectionElement, IHeadProps>((props, ref) => (
diff --git a/packages/tables/src/elements/HeaderCell.tsx b/packages/tables/src/elements/HeaderCell.tsx
index 80451fd4cd2..cf932f317e4 100644
--- a/packages/tables/src/elements/HeaderCell.tsx
+++ b/packages/tables/src/elements/HeaderCell.tsx
@@ -12,6 +12,8 @@ import { useTableContext } from '../utils/useTableContext';
 import { Cell } from './Cell';
 
 /**
+ * @deprecated use `Table.HeaderCell` instead
+ *
  * @extends ThHTMLAttributes<HTMLTableCellElement>
  */
 export const HeaderCell = forwardRef<HTMLTableCellElement, IHeaderCellProps>(
diff --git a/packages/tables/src/elements/HeaderRow.tsx b/packages/tables/src/elements/HeaderRow.tsx
index 13af52d33ae..8ac0295c85b 100644
--- a/packages/tables/src/elements/HeaderRow.tsx
+++ b/packages/tables/src/elements/HeaderRow.tsx
@@ -10,6 +10,8 @@ import { StyledHeaderRow } from '../styled';
 import { useTableContext } from '../utils/useTableContext';
 
 /**
+ * @deprecated use `Table.HeaderRow` instead
+ *
  * @extends HTMLAttributes<HTMLTableRowElement>
  */
 export const HeaderRow = React.forwardRef<HTMLTableRowElement, HTMLAttributes<HTMLTableRowElement>>(
diff --git a/packages/tables/src/elements/OverflowButton.tsx b/packages/tables/src/elements/OverflowButton.tsx
index fd24cb8a518..23eb7aeb3c1 100644
--- a/packages/tables/src/elements/OverflowButton.tsx
+++ b/packages/tables/src/elements/OverflowButton.tsx
@@ -22,6 +22,8 @@ export interface IOverflowButtonProps extends ButtonHTMLAttributes<HTMLButtonEle
 }
 
 /**
+ * @deprecated use `Table.OverflowButton` instead
+ *
  * @extends ButtonHTMLAttributes<HTMLButtonElement>
  */
 export const OverflowButton = forwardRef<HTMLButtonElement, IOverflowButtonProps>(
diff --git a/packages/tables/src/elements/Row.tsx b/packages/tables/src/elements/Row.tsx
index 6943c56b429..004fa4c39b6 100644
--- a/packages/tables/src/elements/Row.tsx
+++ b/packages/tables/src/elements/Row.tsx
@@ -13,6 +13,8 @@ import { StyledRow } from '../styled';
 import { useTableContext } from '../utils/useTableContext';
 
 /**
+ * @deprecated use `Table.Row` instead
+ *
  * @extends HTMLAttributes<HTMLTableRowElement>
  */
 
diff --git a/packages/tables/src/elements/SortableCell.tsx b/packages/tables/src/elements/SortableCell.tsx
index e969f6501d6..bb7f689887e 100644
--- a/packages/tables/src/elements/SortableCell.tsx
+++ b/packages/tables/src/elements/SortableCell.tsx
@@ -18,6 +18,8 @@ import {
 } from '../styled';
 
 /**
+ * @deprecated use `Table.SortableCell` instead
+ *
  * @extends ButtonHTMLAttributes<HTMLButtonElement>
  */
 export const SortableCell = forwardRef<HTMLButtonElement, ISortableCellProps>(
diff --git a/packages/tables/src/index.ts b/packages/tables/src/index.ts
index e9c69d41a4f..20cceec1aac 100644
--- a/packages/tables/src/index.ts
+++ b/packages/tables/src/index.ts
@@ -5,25 +5,15 @@
  * found at http://www.apache.org/licenses/LICENSE-2.0.
  */
 
-/** @deprecated use `Table.Body` intead */
 export { Body } from './elements/Body';
-/** @deprecated use `Table.Caption` intead */
 export { Caption } from './elements/Caption';
-/** @deprecated use `Table.Cell` intead */
 export { Cell } from './elements/Cell';
-/** @deprecated use `Table.GroupRow` intead */
 export { GroupRow } from './elements/GroupRow';
-/** @deprecated use `Table.Head` intead */
 export { Head } from './elements/Head';
-/** @deprecated use `Table.HeaderCell` intead */
 export { HeaderCell } from './elements/HeaderCell';
-/** @deprecated use `Table.HeaderRow` intead */
 export { HeaderRow } from './elements/HeaderRow';
-/** @deprecated use `Table.OverflowButton` intead */
 export { OverflowButton } from './elements/OverflowButton';
-/** @deprecated use `Table.Row` intead */
 export { Row } from './elements/Row';
-/** @deprecated use `Table.SortableCell` intead */
 export { SortableCell } from './elements/SortableCell';
 
 export { Table } from './elements/Table';