From 6d56df7c1012e48dbfc54fbfe358bd15e8bd290a Mon Sep 17 00:00:00 2001
From: Zeno Kapitein <zeno@gitbook.io>
Date: Wed, 5 Nov 2025 08:40:15 +0100
Subject: [PATCH] Treat pages without visible TOC items as `no-toc` (#3783)

---
 .changeset/slow-boxes-go.md                           | 5 +++++
 packages/gitbook/src/components/PageBody/PageBody.tsx | 9 ++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/slow-boxes-go.md

diff --git a/.changeset/slow-boxes-go.md b/.changeset/slow-boxes-go.md
new file mode 100644
index 000000000..1d16b3fbe
--- /dev/null
+++ b/.changeset/slow-boxes-go.md
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Treat pages without visible TOC items as `no-toc`
diff --git a/packages/gitbook/src/components/PageBody/PageBody.tsx b/packages/gitbook/src/components/PageBody/PageBody.tsx
index adbe4de32..05fdb798a 100644
--- a/packages/gitbook/src/components/PageBody/PageBody.tsx
+++ b/packages/gitbook/src/components/PageBody/PageBody.tsx
@@ -46,6 +46,11 @@ export function PageBody(props: {
     const language = getSpaceLanguage(context);
     const updatedAt = page.updatedAt ?? page.createdAt;
 
+    const hasVisibleTOCItems =
+        context.revision.pages.filter(
+            (page) => page.type !== 'document' || (page.type === 'document' && !page.hidden)
+        ).length > 0;
+
     return (
         <CurrentPageProvider page={{ spaceId: context.space.id, pageId: page.id }}>
             <main
@@ -56,7 +61,9 @@ export function PageBody(props: {
                     'break-anywhere',
                     pageWidthWide ? 'page-width-wide 3xl:px-8' : 'page-width-default',
                     siteWidthWide ? 'site-width-wide' : 'site-width-default',
-                    page.layout.tableOfContents ? 'page-has-toc' : 'page-no-toc'
+                    page.layout.tableOfContents && hasVisibleTOCItems
+                        ? 'page-has-toc'
+                        : 'page-no-toc'
                 )}
             >
                 <PreservePageLayout siteWidthWide={siteWidthWide} />