From 7594a334d8485832f465f2118ce2656c4ece41af Mon Sep 17 00:00:00 2001
From: Tomek <tomasz@gitbook.io>
Date: Tue, 11 Aug 2026 13:09:16 +0200
Subject: [PATCH] Show image thumbnails for file attachments (#4486)

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
---
 .changeset/svg-file-attachment-previews.md    |  5 +++
 .../src/components/DocumentView/File.tsx      | 31 +++++++++++++++----
 2 files changed, 30 insertions(+), 6 deletions(-)
 create mode 100644 .changeset/svg-file-attachment-previews.md

diff --git a/.changeset/svg-file-attachment-previews.md b/.changeset/svg-file-attachment-previews.md
new file mode 100644
index 000000000..b3e3c166b
--- /dev/null
+++ b/.changeset/svg-file-attachment-previews.md
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Show image thumbnails, including SVG previews, for file attachments on published sites.
diff --git a/packages/gitbook/src/components/DocumentView/File.tsx b/packages/gitbook/src/components/DocumentView/File.tsx
index 1f4ac18dd..f3187c558 100644
--- a/packages/gitbook/src/components/DocumentView/File.tsx
+++ b/packages/gitbook/src/components/DocumentView/File.tsx
@@ -1,12 +1,12 @@
-import { type DocumentBlockFile, SiteInsightsLinkPosition } from '@gitbook/api';
-
 import { t } from '@/intl/translate';
 import { getSimplifiedContentType } from '@/lib/files';
 import { resolveContentRefInDocument } from '@/lib/references';
+import { type DocumentBlockFile, SiteInsightsLinkPosition } from '@gitbook/api';
 
 import { getSpaceLanguage } from '@/intl/server';
 import { Button, Link } from '../primitives';
 import { DownloadButton } from '../primitives/DownloadButton';
+import { Image } from '../utils';
 import type { BlockProps } from './Block';
 import { Caption } from './Caption';
 import { FileIcon } from './FileIcon';
@@ -42,9 +42,24 @@ export async function File(props: BlockProps<DocumentBlockFile>) {
     return (
         <Caption {...props} withBorder>
             <div className="flex flex-wrap items-center gap-5 px-5 py-3">
-                <div className="flex min-w-14 flex-col items-center gap-1 border-tint-subtle border-r pr-5">
-                    <FileIcon contentType={contentType} className="size-5 text-primary" />
-                    <div className="text-hint text-xs">{getHumanFileSize(file.size)}</div>
+                <div className="flex min-h-8 min-w-14 flex-col items-center justify-center gap-1 border-tint-subtle border-r pr-4">
+                    {contentType === 'image' ? (
+                        <Image
+                            alt={file.name}
+                            className="h-auto max-h-10 w-auto max-w-10 rounded object-contain"
+                            sizes={[{ width: 40 }]}
+                            resize={context.contentContext?.imageResizer}
+                            sources={{
+                                light: {
+                                    src: file.downloadURL,
+                                    size: file.dimensions,
+                                },
+                            }}
+                            loading="lazy"
+                        />
+                    ) : (
+                        <FileIcon contentType={contentType} className="size-5 text-primary" />
+                    )}
                 </div>
                 <div className="min-w-24 flex-1">
                     <div className="text-base">
@@ -57,7 +72,11 @@ export async function File(props: BlockProps<DocumentBlockFile>) {
                             {file.name}
                         </Link>
                     </div>
-                    <div className="text-sm opacity-9 dark:opacity-8">{contentType}</div>
+                    <div className="text-sm text-tint-subtle">
+                        {contentType
+                            ? `${contentType} · ${getHumanFileSize(file.size)}`
+                            : getHumanFileSize(file.size)}
+                    </div>
                 </div>
                 <div className="flex shrink-0 flex-wrap gap-2">
                     <DownloadButton