diff --git a/README.md b/README.md
index d17f0283..0aa8d458 100644
--- a/README.md
+++ b/README.md
@@ -236,6 +236,9 @@ FAQ
#### Why do vertical images take up so much space?
> By default, all photos are shown full-width, regardless of orientation. Enable matting to showcase horizontal and vertical photos at similar scales by setting `NEXT_PUBLIC_MATTE_PHOTOS = 1`.
+#### Why are my grid thumbnails so small?
+Thumbnail grid density (seen on `/grid`, tag overviews, and other photo sets) is dependent on the aspect ratio configuration (ratios of 1 and under have larger amounts of photos per row). This can be overridden by setting `NEXT_PUBLIC_SHOW_LARGE_THUMBNAILS = 1`.
+
#### How secure are photos marked “hidden?”
> While all hidden paths (`/tag/hidden/*`) require authentication, raw links to individual photo assets remain publicly accessible. Randomly generated urls from storage providers are only secure via obscurity. Use with caution.
diff --git a/src/site/SiteChecklistClient.tsx b/src/site/SiteChecklistClient.tsx
index b18c7202..6d7a7686 100644
--- a/src/site/SiteChecklistClient.tsx
+++ b/src/site/SiteChecklistClient.tsx
@@ -68,6 +68,8 @@ export default function SiteChecklistClient({
isOgTextBottomAligned,
gridAspectRatio,
hasGridAspectRatio,
+ gridDensity,
+ hasGridDensityPreference,
// Connection status
databaseError,
storageError,
@@ -577,6 +579,16 @@ export default function SiteChecklistClient({
(default is {'"1"'}, i.e., square)—set to {'"0"'} to disable:
{renderEnvVars(['NEXT_PUBLIC_GRID_ASPECT_RATIO'])}
+
+ Set environment variable to {'"1"'} to ensure large thumbnails
+ on photo grid views (if not configured, density is based on
+ aspect ratio configuration):
+ {renderEnvVars(['NEXT_PUBLIC_SHOW_LARGE_THUMBNAILS'])}
+