diff --git a/packages/gitbook/src/components/TableOfContents/PageDocumentItem.tsx b/packages/gitbook/src/components/TableOfContents/PageDocumentItem.tsx
index 13b3988873..d5a98af11f 100644
--- a/packages/gitbook/src/components/TableOfContents/PageDocumentItem.tsx
+++ b/packages/gitbook/src/components/TableOfContents/PageDocumentItem.tsx
@@ -10,6 +10,7 @@ import { ToggleableLinkItem } from './ToggleableLinkItem';
export function PageDocumentItem(props: { page: ClientTOCPageDocument }) {
const { page } = props;
+ const title = page.linkTitle || page.title;
return (
@@ -41,10 +42,10 @@ export function PageDocumentItem(props: { page: ClientTOCPageDocument }) {
{page.emoji || page.icon ? (
- {page.title}
+ {title}
) : (
- page.title
+ title
)}
diff --git a/packages/gitbook/src/components/TableOfContents/encodeClientTableOfContents.ts b/packages/gitbook/src/components/TableOfContents/encodeClientTableOfContents.ts
index 3c3820c3f0..d087e80dc6 100644
--- a/packages/gitbook/src/components/TableOfContents/encodeClientTableOfContents.ts
+++ b/packages/gitbook/src/components/TableOfContents/encodeClientTableOfContents.ts
@@ -72,7 +72,7 @@ export async function encodeClientTableOfContents(
result.push(
removeUndefined({
id: page.id,
- title: page.title,
+ title: page.linkTitle ?? page.title,
href,
emoji: page.emoji,
icon: page.icon,
diff --git a/packages/gitbook/src/lib/references.tsx b/packages/gitbook/src/lib/references.tsx
index 37938459d8..8a5455e331 100644
--- a/packages/gitbook/src/lib/references.tsx
+++ b/packages/gitbook/src/lib/references.tsx
@@ -134,7 +134,7 @@ export async function resolveContentRef(
const page = resolvePageResult?.page;
const ancestors =
resolvePageResult?.ancestors.map((ancestor) => ({
- label: ancestor.title,
+ label: ancestor.linkTitle ?? ancestor.title,
icon:
ancestor.emoji || ancestor.icon ? (
,
href,
});
@@ -182,7 +182,7 @@ export async function resolveContentRef(
parentPage && contentRef.page === parentPage.id && parentPage.type === 'group'
? parentPage
: page;
- text = pageOrGroup.title;
+ text = pageOrGroup.linkTitle ?? pageOrGroup.title;
emoji = isCurrentPage ? undefined : page.emoji;
icon = ;
}