From b838cc97b0f42b98d05b12e9eaa72be7cca3af92 Mon Sep 17 00:00:00 2001
From: Jonathan Roebuck <jroebuck@spotify.com>
Date: Fri, 13 Mar 2026 11:52:08 +0000
Subject: [PATCH] docs(ui): add changeset and docs for TableRoot loading prop

Signed-off-by: Jonathan Roebuck <jroebuck@spotify.com>
---
 .changeset/bui-table-root-loading-prop.md             |  7 +++++++
 docs-ui/src/app/components/table/props-definition.tsx | 11 +++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 .changeset/bui-table-root-loading-prop.md

diff --git a/.changeset/bui-table-root-loading-prop.md b/.changeset/bui-table-root-loading-prop.md
new file mode 100644
index 0000000000..b5728154cc
--- /dev/null
+++ b/.changeset/bui-table-root-loading-prop.md
@@ -0,0 +1,7 @@
+---
+'@backstage/ui': patch
+---
+
+Added a `loading` prop and `data-loading` data attribute to `TableRoot`, allowing consumers to distinguish between stale data and initial loading states. Both `stale` and `loading` set `aria-busy` on the table.
+
+Affected components: Table
diff --git a/docs-ui/src/app/components/table/props-definition.tsx b/docs-ui/src/app/components/table/props-definition.tsx
index abfdd45549..6d35cb3350 100644
--- a/docs-ui/src/app/components/table/props-definition.tsx
+++ b/docs-ui/src/app/components/table/props-definition.tsx
@@ -430,6 +430,17 @@ export const tableRootPropDefs: Record<string, PropDef> = {
       </>
     ),
   },
+  loading: {
+    type: 'boolean',
+    default: 'false',
+    description: (
+      <>
+        Whether the table is in a loading state (e.g., initial data fetch). Adds{' '}
+        <Chip>aria-busy</Chip> attribute and <Chip>data-loading</Chip> data
+        attribute for styling.
+      </>
+    ),
+  },
 };
 
 export const columnPropDefs: Record<string, PropDef> = {