diff --git a/docs/api/routes/brand/list.md b/docs/api/routes/brand/list.md
index 4ca4227..05f8381 100644
--- a/docs/api/routes/brand/list.md
+++ b/docs/api/routes/brand/list.md
@@ -4,7 +4,7 @@ Protected. Requires a valid session cookie (`credentials: 'include'`).
 
 List brands
 
-Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count. Small-thumbnail fields are omitted by default. Set `includeSmallThumbs=true` to include each picture's `smallThumbW`, `smallThumbH`, and `smallThumbBinary` (base64-encoded AVIF bytes, resized with a 40px maximum edge).
+Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count. Small-thumbnail fields are omitted by default. Set `includeSmallThumbs=true` to include each picture's `smallThumbW`, `smallThumbH`, and `smallThumbBinary` (base64-encoded AVIF bytes, resized with a 32px maximum edge).
 
 ## Query parameters
 
diff --git a/docs/api/routes/smallthumb/get.md b/docs/api/routes/smallthumb/get.md
index 8a78682..2e04129 100644
--- a/docs/api/routes/smallthumb/get.md
+++ b/docs/api/routes/smallthumb/get.md
@@ -4,7 +4,7 @@ Protected. Requires a valid session cookie (`credentials: 'include'`).
 
 Small thumb image by hash
 
-Returns the small thumb AVIF (40px max edge) for `pic.hash` (fullHash — not thumbhash).
+Returns the small thumb AVIF (32px max edge) for `pic.hash` (fullHash — not thumbhash).
 Auth via article category access. Browser-cacheable (`private`, `immutable`, `ETag`).
 
 
diff --git a/src/api/openapi.js b/src/api/openapi.js
index 8761ce2..6ce7550 100644
--- a/src/api/openapi.js
+++ b/src/api/openapi.js
@@ -407,7 +407,7 @@
  *           nullable: true
  *         pics:
  *           type: array
- *           description: Brand pictures sorted by sort, including the 40px-edge small thumbnail
+ *           description: Brand pictures sorted by sort, including the 32px-edge small thumbnail
  *           items:
  *             $ref: '#/components/schemas/BrandListPic'
  *     ArticleBrand:
diff --git a/src/api/routes/brand.js b/src/api/routes/brand.js
index 305a007..c80a467 100644
--- a/src/api/routes/brand.js
+++ b/src/api/routes/brand.js
@@ -51,7 +51,7 @@ export function register(app, basePath = '') {
      *   get:
      *     tags: [Brand]
      *     summary: List brands
-     *     description: Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count. Small-thumbnail fields are omitted by default. Set `includeSmallThumbs=true` to include each picture's `smallThumbW`, `smallThumbH`, and `smallThumbBinary` (base64-encoded AVIF bytes, resized with a 40px maximum edge).
+     *     description: Lists brands for the authenticated user's selected company, sorted by name. Paged; `total` is the unpaged count. Small-thumbnail fields are omitted by default. Set `includeSmallThumbs=true` to include each picture's `smallThumbW`, `smallThumbH`, and `smallThumbBinary` (base64-encoded AVIF bytes, resized with a 32px maximum edge).
      *     security:
      *       - cookieAuth: []
      *     parameters:
diff --git a/src/api/routes/pic.js b/src/api/routes/pic.js
index 7cde5b5..f295248 100644
--- a/src/api/routes/pic.js
+++ b/src/api/routes/pic.js
@@ -229,7 +229,7 @@ export function register(app, basePath = '') {
      *     tags: [Image]
      *     summary: Small thumb image by hash
      *     description: |
-     *       Returns the small thumb AVIF (40px max edge) for `pic.hash` (fullHash — not thumbhash).
+     *       Returns the small thumb AVIF (32px max edge) for `pic.hash` (fullHash — not thumbhash).
      *       Auth via article category access. Browser-cacheable (`private`, `immutable`, `ETag`).
      *     security:
      *       - cookieAuth: []